@specforge/canary-cli 0.1.0

package/node_modules/@specforge/types/dist/schema/extensions/epic.extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"epic.extensions.js","sourceRoot":"","sources":["../../../src/schema/extensions/epic.extensions.ts"],"names":[],"mappings":";AAAA,sEAAsE;AACtE,sBAAsB"}

package/node_modules/@specforge/types/dist/schema/extensions/specification.extensions.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Readiness level for specifications, using diamond-cut progression.
+ * Not in the published schema — internal quality gate.
+ */
+export type ReadinessLevel = 'raw' | 'cut' | 'polished' | 'flawless';
+//# sourceMappingURL=specification.extensions.d.ts.map

package/node_modules/@specforge/types/dist/schema/extensions/specification.extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specification.extensions.d.ts","sourceRoot":"","sources":["../../../src/schema/extensions/specification.extensions.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,UAAU,GAAG,UAAU,CAAC"}

package/node_modules/@specforge/types/dist/schema/extensions/specification.extensions.js

@@ -0,0 +1,3 @@
+// Internal types extending published Specification schema — not parity-checked
+export {};
+//# sourceMappingURL=specification.extensions.js.map

package/node_modules/@specforge/types/dist/schema/extensions/specification.extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specification.extensions.js","sourceRoot":"","sources":["../../../src/schema/extensions/specification.extensions.ts"],"names":[],"mappings":"AAAA,+EAA+E"}

package/node_modules/@specforge/types/dist/schema/extensions/ticket.extensions.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Validation status for test specifications on tickets.
+ * Not in the published schema — used by core and codegen internally.
+ */
+export type TestValidationStatus = 'passed' | 'failed' | 'partial' | 'pending';
+//# sourceMappingURL=ticket.extensions.d.ts.map

package/node_modules/@specforge/types/dist/schema/extensions/ticket.extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticket.extensions.d.ts","sourceRoot":"","sources":["../../../src/schema/extensions/ticket.extensions.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC"}

package/node_modules/@specforge/types/dist/schema/extensions/ticket.extensions.js

@@ -0,0 +1,3 @@
+// Internal types extending published Ticket schema — not parity-checked
+export {};
+//# sourceMappingURL=ticket.extensions.js.map

package/node_modules/@specforge/types/dist/schema/extensions/ticket.extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticket.extensions.js","sourceRoot":"","sources":["../../../src/schema/extensions/ticket.extensions.ts"],"names":[],"mappings":"AAAA,wEAAwE"}

package/node_modules/@specforge/types/dist/schema/index.d.ts

@@ -0,0 +1,7 @@
+export * from './project.js';
+export * from './specification.js';
+export * from './epic.js';
+export * from './ticket.js';
+export * from './blueprint.js';
+export * from './patterns.js';
+//# sourceMappingURL=index.d.ts.map

package/node_modules/@specforge/types/dist/schema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}

package/node_modules/@specforge/types/dist/schema/index.js

@@ -0,0 +1,7 @@
+export * from './project.js';
+export * from './specification.js';
+export * from './epic.js';
+export * from './ticket.js';
+export * from './blueprint.js';
+export * from './patterns.js';
+//# sourceMappingURL=index.js.map

package/node_modules/@specforge/types/dist/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}

package/node_modules/@specforge/types/dist/schema/patterns.d.ts

@@ -0,0 +1,6 @@
+export interface Patterns {
+    codeStandards?: Record<string, unknown>;
+    commonImports?: string[];
+    returnTypes?: Record<string, unknown>;
+}
+//# sourceMappingURL=patterns.d.ts.map

package/node_modules/@specforge/types/dist/schema/patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.d.ts","sourceRoot":"","sources":["../../src/schema/patterns.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,QAAQ;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC"}

package/node_modules/@specforge/types/dist/schema/patterns.js

@@ -0,0 +1,3 @@
+// Mirrors specforge-schema.json v1.0 — DO NOT modify without updating the schema first
+export {};
+//# sourceMappingURL=patterns.js.map

package/node_modules/@specforge/types/dist/schema/patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.js","sourceRoot":"","sources":["../../src/schema/patterns.ts"],"names":[],"mappings":"AAAA,uFAAuF"}

package/node_modules/@specforge/types/dist/schema/project.d.ts

@@ -0,0 +1,7 @@
+export interface Project {
+    id: string;
+    name: string;
+    description?: string;
+    tags?: string[];
+}
+//# sourceMappingURL=project.d.ts.map

package/node_modules/@specforge/types/dist/schema/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/schema/project.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB"}

package/node_modules/@specforge/types/dist/schema/project.js

@@ -0,0 +1,3 @@
+// Mirrors specforge-schema.json v1.0 — DO NOT modify without updating the schema first
+export {};
+//# sourceMappingURL=project.js.map

package/node_modules/@specforge/types/dist/schema/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/schema/project.ts"],"names":[],"mappings":"AAAA,uFAAuF"}

package/node_modules/@specforge/types/dist/schema/specification.d.ts

@@ -0,0 +1,35 @@
+import type { Blueprint } from './blueprint.js';
+import type { Epic } from './epic.js';
+import type { Patterns } from './patterns.js';
+export type SpecificationStatus = 'draft' | 'planning' | 'ready' | 'in_progress' | 'ready_for_review' | 'in_review' | 'reviewed' | 'done';
+export type SpecificationPriority = 'high' | 'medium' | 'low';
+export interface Specification {
+    id: string;
+    title: string;
+    description?: string;
+    content?: string;
+    status?: 'draft' | 'planning' | 'ready' | 'in_progress' | 'ready_for_review' | 'in_review' | 'reviewed' | 'done';
+    background?: string;
+    scope?: string;
+    goals?: string[];
+    requirements?: string[];
+    nonFunctionalRequirements?: string[];
+    acceptanceCriteria?: string[];
+    successMetrics?: string[];
+    guardrails?: string[];
+    constraints?: string[];
+    assumptions?: string[];
+    risks?: string[];
+    architecture?: string;
+    fileStructure?: string;
+    techStack?: string[];
+    dependencies?: string[];
+    apiContracts?: {};
+    priority?: 'high' | 'medium' | 'low';
+    tags?: string[];
+    estimatedHours?: number;
+    patterns?: Patterns;
+    epics?: Epic[];
+    blueprints?: Blueprint[];
+}
+//# sourceMappingURL=specification.d.ts.map

package/node_modules/@specforge/types/dist/schema/specification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specification.d.ts","sourceRoot":"","sources":["../../src/schema/specification.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,MAAM,mBAAmB,GAC3B,OAAO,GACP,UAAU,GACV,OAAO,GACP,aAAa,GACb,kBAAkB,GAClB,WAAW,GACX,UAAU,GACV,MAAM,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE9D,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EACH,OAAO,GACP,UAAU,GACV,OAAO,GACP,aAAa,GACb,kBAAkB,GAClB,WAAW,GACX,UAAU,GACV,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,yBAAyB,CAAC,EAAE,MAAM,EAAE,CAAC;IACrC,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACrC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;CAC1B"}

package/node_modules/@specforge/types/dist/schema/specification.js

@@ -0,0 +1,3 @@
+// Mirrors specforge-schema.json v1.0 — DO NOT modify without updating the schema first
+export {};
+//# sourceMappingURL=specification.js.map

package/node_modules/@specforge/types/dist/schema/specification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specification.js","sourceRoot":"","sources":["../../src/schema/specification.ts"],"names":[],"mappings":"AAAA,uFAAuF"}

package/node_modules/@specforge/types/dist/schema/ticket.d.ts

@@ -0,0 +1,69 @@
+export type TicketStatus = 'pending' | 'ready' | 'active' | 'done';
+export type Complexity = 'small' | 'medium' | 'large' | 'xlarge';
+export type Priority = 'critical' | 'high' | 'medium' | 'low';
+export type DependencyType = 'blocks' | 'requires';
+export interface TicketImplementation {
+    steps?: string[];
+    filesToCreate?: string[];
+    filesToModify?: string[];
+    notes?: string;
+}
+export interface TicketCodeReference {
+    name: string;
+    code: string;
+    language?: string;
+}
+export interface TicketTypeReference {
+    name: string;
+    definition: string;
+}
+export interface TicketTestSpecification {
+    types?: string[];
+    commands?: string[];
+    gates?: string[];
+}
+export interface TicketDependency {
+    dependsOnId: string;
+    type: 'blocks' | 'requires';
+}
+export interface Ticket {
+    id: string;
+    ticketNumber?: number;
+    title: string;
+    description?: string;
+    notes?: string;
+    status?: 'pending' | 'ready' | 'active' | 'done';
+    complexity?: 'small' | 'medium' | 'large' | 'xlarge';
+    priority?: 'critical' | 'high' | 'medium' | 'low';
+    order?: number;
+    estimatedHours?: number;
+    actualHours?: number;
+    acceptanceCriteria?: string[];
+    implementation?: {
+        steps?: string[];
+        filesToCreate?: string[];
+        filesToModify?: string[];
+        notes?: string;
+    };
+    codeReferences?: {
+        name: string;
+        code: string;
+        language?: string;
+    }[];
+    technicalDetails?: {};
+    typeReferences?: {
+        name: string;
+        definition: string;
+    }[];
+    testSpecification?: {
+        types?: string[];
+        commands?: string[];
+        gates?: string[];
+    };
+    dependencies?: {
+        dependsOnId: string;
+        type: 'blocks' | 'requires';
+    }[];
+    tags?: string[];
+}
+//# sourceMappingURL=ticket.d.ts.map

package/node_modules/@specforge/types/dist/schema/ticket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticket.d.ts","sourceRoot":"","sources":["../../src/schema/ticket.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEnE,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEjE,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE9D,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEnD,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC;CAC7B;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IACjD,UAAU,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IACrD,QAAQ,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,cAAc,CAAC,EAAE;QACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QACzB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,cAAc,CAAC,EAAE;QACf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,EAAE,CAAC;IACJ,gBAAgB,CAAC,EAAE,EAAE,CAAC;IACtB,cAAc,CAAC,EAAE;QACf,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;KACpB,EAAE,CAAC;IACJ,iBAAiB,CAAC,EAAE;QAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;IACF,YAAY,CAAC,EAAE;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC;KAC7B,EAAE,CAAC;IACJ,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB"}

package/node_modules/@specforge/types/dist/schema/ticket.js

@@ -0,0 +1,3 @@
+// Mirrors specforge-schema.json v1.0 — DO NOT modify without updating the schema first
+export {};
+//# sourceMappingURL=ticket.js.map

package/node_modules/@specforge/types/dist/schema/ticket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticket.js","sourceRoot":"","sources":["../../src/schema/ticket.ts"],"names":[],"mappings":"AAAA,uFAAuF"}

package/node_modules/@specforge/types/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@specforge/types",
+  "version": "1.0.2",
+  "description": "Shared SpecForge type definitions (schema + runtime + api + mcp).",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "publishConfig": {
+    "registry": "https://specforge-316884453263.d.codeartifact.us-east-1.amazonaws.com/npm/npm-packages/"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./schema": {
+      "types": "./dist/schema/index.d.ts",
+      "import": "./dist/schema/index.js"
+    },
+    "./runtime": {
+      "types": "./dist/runtime/index.d.ts",
+      "import": "./dist/runtime/index.js"
+    },
+    "./api": {
+      "types": "./dist/api/index.d.ts",
+      "import": "./dist/api/index.js"
+    },
+    "./mcp": {
+      "types": "./dist/mcp/index.d.ts",
+      "import": "./dist/mcp/index.js"
+    }
+  },
+  "scripts": {
+    "schema:fetch": "tsx scripts/fetch-schema.ts",
+    "schema:generate": "tsx scripts/generate-from-schema.ts",
+    "schema:parity": "tsx scripts/parity-check.ts",
+    "build": "pnpm schema:fetch && pnpm schema:generate && pnpm schema:parity && tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:types": "node scripts/run-tsd.mjs",
+    "test:all": "pnpm test && pnpm test:types"
+  },
+  "tsd": {
+    "directory": "tests/type-level",
+    "compilerOptions": {
+      "composite": false,
+      "rootDir": ".",
+      "strict": true,
+      "noEmit": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "@vitest/coverage-v8": "4.0.18",
+    "ajv": "^8.18.0",
+    "json-schema-to-typescript": "^15.0.4",
+    "tsd": "^0.33.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.3.3",
+    "vitest": "4.0.18"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@specforge/canary-cli",
+  "version": "0.1.0",
+  "description": "MCP server for SpecForge - AI agent integration",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "bin": {
+    "specforge-canary": "./bin/specforge"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@toon-format/toon": "^2.1.0",
+    "chalk": "^5.6.2",
+    "cli-table3": "^0.6.5",
+    "commander": "^12.1.0",
+    "inquirer": "^9.3.8",
+    "minimatch": "^10.1.1",
+    "ora": "^8.2.0",
+    "@specforge/types": "1.0.2"
+  },
+  "devDependencies": {
+    "@types/inquirer": "^9.0.9",
+    "@types/minimatch": "^5.1.2",
+    "@types/node": "^20.0.0",
+    "@vitest/coverage-v8": "4.0.18",
+    "mock-fs": "^5.5.0",
+    "tsup": "^8.5.1",
+    "tsx": "^4.7.0",
+    "typescript": "^5.0.0",
+    "vitest": "4.0.18"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "src/cli/templates"
+  ],
+  "keywords": [
+    "mcp",
+    "specforge",
+    "ai",
+    "claude",
+    "cursor",
+    "copilot"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bundleDependencies": [
+    "@specforge/types"
+  ],
+  "gitHead": "7af072264a89b9a7916806949d9ee90b9d6fc37b",
+  "scripts": {
+    "build": "tsup && tsc --emitDeclarationOnly --outDir dist",
+    "typecheck": "tsc --noEmit",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:planning": "vitest run --config vitest.planning.config.ts",
+    "test:coverage": "vitest run --coverage",
+    "test:real": "vitest run --config vitest.real.config.ts",
+    "test:real:watch": "vitest --config vitest.real.config.ts",
+    "test:smoke": "vitest run --config vitest.real.config.ts src/__tests__/real/smoke",
+    "seed:planning": "tsx src/__tests__/integration/seed-planning-session.ts",
+    "seed:implementation": "tsx src/__tests__/integration/seed-implementation-session.ts",
+    "seed:review": "tsx src/__tests__/integration/seed-review-session.ts",
+    "seed:canary": "tsx src/__tests__/integration/seed-ticket-status-canary.ts",
+    "test:implementation": "vitest run --config vitest.implementation.config.ts",
+    "test:review": "vitest run --config vitest.review.config.ts"
+  }
+}

package/src/cli/templates/agents/content/core/sfag-orchestrator.ts

@@ -0,0 +1,165 @@
+/**
+ * SFAG-Orchestrator Agent Template v2
+ *
+ * Strategic task decomposition with concrete decision trees.
+ * Knows when to delegate, to whom, and in what order.
+ */
+
+import type { AgentTemplate } from '../../../../commands/scaffold/agent-types.js';
+
+export const SFAG_ORCHESTRATOR: AgentTemplate = {
+  name: 'sfag-orchestrator',
+  description: 'Decompose complex tasks and coordinate specialized agents',
+  triggerDescription: `Use this agent when a task spans multiple domains and requires coordination between specialized agents. The orchestrator decides WHAT to delegate, to WHOM, and in WHAT ORDER.
+
+<example>
+Context: User requests a full feature that needs spec + implementation + tests
+user: "Preciso de um módulo completo de pagamentos — desde a spec até deploy"
+assistant: "This spans multiple domains. Launching sfag-orchestrator to decompose and coordinate."
+</example>
+
+<example>
+Context: User has a complex task touching schema, API, frontend, and tests
+user: "Adiciona um sistema de comentários — precisa de tabela, API, componente, e testes"
+assistant: "Multi-domain task detected. Launching sfag-orchestrator to plan the execution."
+</example>
+
+<example>
+Context: User needs analysis across multiple dimensions
+user: "Faz uma análise completa desse módulo — segurança, performance, e qualidade"
+assistant: "Launching sfag-orchestrator to coordinate a multi-perspective analysis."
+</example>`,
+  model: 'opus',
+  color: 'magenta',
+  category: 'Orchestration',
+  memory: 'project',
+  content: `# SpecForge Orchestrator Agent
+
+You are the brain. You don't write code. You don't write specs. You decide WHO does WHAT and WHEN, then you make it happen.
+
+## Context Bootstrapping
+
+Before any decision, read the project context from the local config:
+\`\`\`
+Read .specforge.json from project root → extract:
+  - project.id → projectId
+  - activeSpecification.id → specificationId (may be null if no spec exists yet)
+  - agentTeams config (if Agent Teams mode)
+\`\`\`
+All tool calls that need projectId/specificationId use these values. No session store, no get_working_context.
+
+## Available Agents
+
+| Agent | What it does | When to use |
+|-------|-------------|-------------|
+| **sfag-spec-creator** | Dense interrogation → SpecForge spec | When requirements are unclear or no spec exists |
+| **sfag-ticket-implementer** | Lifecycle-tracked ticket implementation | When a spec exists and tickets are ready |
+| **sfag-package-researcher** | Web research for packages/APIs/docs | When external knowledge is needed before implementation |
+
+## Decision Tree
+
+When a task arrives, follow this tree:
+
+### 1. Does a specification exist for this work?
+
+**NO →** Route to \`sfag-spec-creator\` first. Full stop. No implementation without a spec.
+
+**YES →** Continue to step 2.
+
+### 2. Does the task require external package/API knowledge?
+
+**YES →** Launch \`sfag-package-researcher\` BEFORE implementation. Feed research output into implementation context.
+
+**NO →** Continue to step 3.
+
+### 3. Are tickets created and ready?
+
+**NO →** Check if the spec needs more tickets. If yes, route back to \`sfag-spec-creator\` for ticket creation. If tickets exist but are blocked, diagnose with:
+\`\`\`
+get_blocked_tickets({ specificationId })
+get_dependency_tree({ specificationId })
+\`\`\`
+
+**YES →** Route to \`sfag-ticket-implementer\`. Give it the ticket ID or let it pick from actionable tickets.
+
+### 4. Is this a multi-ticket task?
+
+**YES →** Determine execution order:
+\`\`\`
+get_critical_path({ specificationId })
+get_next_actionable_tickets({ specificationId })
+\`\`\`
+Launch \`sfag-ticket-implementer\` for each ticket in dependency order. Between tickets, verify the previous completed successfully before starting the next.
+
+**NO →** Single ticket, single launch.
+
+## Coordination Patterns
+
+### Pattern A: Greenfield Feature
+\`\`\`
+sfag-spec-creator (interrogation → spec + epics + tickets)
+  ↓
+sfag-package-researcher (if unknown packages involved)
+  ↓
+sfag-ticket-implementer (ticket 1 → ticket 2 → ... → ticket N)
+\`\`\`
+
+### Pattern B: Add to Existing Spec
+\`\`\`
+Check spec status → create new epic/tickets if needed
+  ↓
+sfag-ticket-implementer (new tickets only)
+\`\`\`
+
+### Pattern C: Research-First Implementation
+\`\`\`
+sfag-package-researcher (gather docs, patterns, gotchas)
+  ↓
+Feed research into ticket notes/context
+  ↓
+sfag-ticket-implementer (implement with research context)
+\`\`\`
+
+### Pattern D: Multi-Domain Parallel
+When tickets are independent (no dependency chain):
+\`\`\`
+sfag-ticket-implementer (ticket A) ─┐
+sfag-ticket-implementer (ticket B) ─┼→ verify all complete
+sfag-ticket-implementer (ticket C) ─┘
+\`\`\`
+
+## Your Responsibilities
+
+### Before Delegation
+- Understand the full scope of the request
+- Check SpecForge state: existing specs, ticket statuses, blockers
+- Identify the right pattern (A, B, C, or D)
+- Load relevant context for the agents you're about to launch
+
+### During Execution
+- Monitor agent outputs for problems
+- If an agent hits a blocker, decide: fix it, skip it, or escalate to user
+- Track which tickets completed and which are next
+- Maintain the execution plan — update if dependencies shift
+
+### After Completion
+- Verify all delegated work completed (check ticket statuses)
+- Report summary to user: what was done, what's pending, what's blocked
+- Suggest next steps if work remains
+
+## What You Are NOT
+
+- You are NOT an implementer. Don't write code. Delegate to ticket-implementer.
+- You are NOT a spec creator. Don't interrogate requirements. Delegate to spec-creator.
+- You are NOT a researcher. Don't search the web. Delegate to package-researcher.
+- You ARE the one who decides the plan, sequences the work, and ensures nothing falls through the cracks.
+
+## Anti-Patterns
+
+- ❌ Don't launch ticket-implementer without a spec. Spec-creator goes first.
+- ❌ Don't implement tickets out of dependency order. Check the critical path.
+- ❌ Don't assume packages are known. If the ticket references an unfamiliar package, research first.
+- ❌ Don't run everything sequentially when tickets are independent. Parallel when possible.
+- ❌ Don't silently skip blockers. Report them to the user with diagnosis.
+`,
+};