Merge pull request #151 from Azure/doc-fixes

Remove speckit task IDs, add doc links to templates, fix test type errors

Author: petehauge

src/cli/extract-command.ts

@@ -1,7 +1,7 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT license.
 /**
- * T028 & T029: Extract command CLI registration
+ * Extract command CLI registration
  * Commander subcommand with --resource-group, --service-name, --output,
  * --filter, --no-transitive, --spec-format flags.
  * Includes --format json: machine-readable JSON output mode.
@@ -131,7 +131,7 @@ async function executeExtract(
 }
 
 /**
- * T029: JSON output mode for extract.
+ * JSON output mode for extract.
  * Machine-readable JSON to stdout with resource counts and file paths.
  */
 function outputJson(result: ExtractionResult): void {

src/cli/index.ts

@@ -3,7 +3,7 @@
 // Licensed under the MIT license.
 
 /**
- * T019: Commander program entry point
+ * Commander program entry point
  * Sets up global options and subcommand registration pattern
  */
 
@@ -51,7 +51,7 @@ program.hook('preAction', (thisCommand) => {
 
   logger.configure({ level: parseLogLevel(opts.logLevel ?? 'info') });
 
-  // T040: Set DefaultAzureCredential env vars from explicit auth flags.
+  // Set DefaultAzureCredential env vars from explicit auth flags.
   // This ensures the ServicePrincipal credential is tried first,
   // avoiding interactive browser prompts in CI/CD pipelines.
   if (opts.clientId) {

src/cli/init-command.ts

@@ -1,7 +1,7 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT license.
 /**
- * T050: Register init command
+ * Register init command
  * Commander subcommand with --ci, --non-interactive, --artifact-dir, --environments flags
  * Wire to init-service
  */

src/cli/publish-command.ts

@@ -1,10 +1,10 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT license.
 /**
- * T037 & T038: Publish command CLI registration
+ * Publish command CLI registration
  * Commander subcommand with --resource-group, --service-name, --source,
  * --overrides, --dry-run, --delete-unmatched flags.
- * Includes --format json: machine-readable JSON output mode (T038).
+ * Includes --format json: machine-readable JSON output mode.
  */
 
 import { Command } from 'commander';
@@ -173,7 +173,7 @@ export function hasMutuallyExclusivePublishOptions(
 }
 
 /**
- * T038: JSON output mode for publish.
+ * JSON output mode for publish.
  * Machine-readable JSON to stdout with action list and summary.
  */
 function outputJson(result: PublishResult): void {

src/clients/apim-client.ts

@@ -1,7 +1,7 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT license.
 /**
- * T016: Azure REST HTTP client implementing IApimClient
+ * Azure REST HTTP client implementing IApimClient
  * Uses @azure/identity DefaultAzureCredential for auth
  * Handles pagination, retry, rate limiting, and long-running operations
  */

src/clients/artifact-store.ts

@@ -1,7 +1,7 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT license.
 /**
- * T017: Filesystem artifact store implementing IArtifactStore
+ * Filesystem artifact store implementing IArtifactStore
  * Read/write resource JSON files, policy XML, API specs, associations, wiki markdown
  */
 

src/clients/iapim-client.ts

@@ -1,7 +1,7 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT license.
 /**
- * T009: IApimClient interface
+ * IApimClient interface
  * Abstraction over Azure APIM REST API calls
  */
 

src/clients/iartifact-store.ts

@@ -1,7 +1,7 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT license.
 /**
- * T010: IArtifactStore interface
+ * IArtifactStore interface
  * Abstraction over local filesystem for reading/writing APIM artifact files
  */
 

src/lib/cloud-config.ts

@@ -1,7 +1,7 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT license.
 /**
- * T039: Sovereign cloud configuration
+ * Sovereign cloud configuration
  * Maps the --cloud CLI flag to ARM base URLs and auth scopes for
  * Azure Public, China, US Government, and Germany clouds.
  */

src/lib/config-loader.ts

@@ -1,7 +1,7 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT license.
 /**
- * T015: YAML config loader with validation
+ * YAML config loader with validation
  * Parse filter YAML, override YAML, and OTel config files
  */