zob-harness 0.2.0 → 0.3.0

package/.pi/extensions/zob-harness/src/runtime/tools-zcommit.ts

@@ -1,9 +1,9 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 
-import { buildZcommitPlan, runGovernedZcommitCommit, runGovernedZcommitPush, type ZcommitCommandResult, type ZcommitPlan, type ZcommitPlanOptions } from "../git-ops.js";
-import { ZcommitRunParams } from "../schemas.js";
+import { buildZcommitPlan, runGovernedZcommitCommit, runGovernedZcommitPush, type ZcommitCommandResult, type ZcommitPlan, type ZcommitPlanOptions } from "../domains/git/git-ops.js";
+import { ZcommitRunParams } from "./schemas.js";
 import type { HarnessRuntimeState } from "./state.js";
-import { sha256 } from "../utils/hashing.js";
+import { sha256 } from "../core/utils/hashing.js";
 
 function uniqueSorted(values: string[]): string[] {
   return [...new Set(values.filter((value) => value.trim().length > 0))].sort();

package/.pi/extensions/zob-harness/src/runtime/widget.ts

@@ -1,13 +1,13 @@
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
 import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 
-import { MODE_TOOLS } from "../constants.js";
-import { buildDaemonRuntimeState, buildDaemonTickPlan } from "../daemon-runtime.js";
-import { goalTodoCompletionDiagnostics, summarizeGoalTodos } from "../goal-todos.js";
-import { isRecord } from "../utils/records.js";
+import { MODE_TOOLS } from "../core/constants.js";
+import { buildDaemonRuntimeState, buildDaemonTickPlan } from "../domains/autonomy/daemon-runtime.js";
+import { goalTodoCompletionDiagnostics, summarizeGoalTodos } from "../domains/goal/goal-todos.js";
+import { isRecord } from "../core/utils/records.js";
 import type { AssistantLikeMessage, ModeName } from "../types.js";
-import { readHarnessReadinessWidgetData } from "../orchestration/widget-readers.js";
-import { buildZpeerPeerRoomSummaries, type ZpeerPeerRoomSummary } from "../coms-v2/zpeer.js";
+import { readHarnessReadinessWidgetData } from "../domains/orchestration/widget-readers.js";
+import { buildZpeerPeerRoomSummaries, type ZpeerPeerRoomSummary } from "../domains/coms/coms-v2/zpeer.js";
 import { delegationCost, delegationDurationMs, formatDelegationCost, formatDuration, summarizeDelegations } from "./delegation-monitor.js";
 import { disposeDelegationMouseSupport } from "./delegation-mouse.js";
 import { formatZcompactHudLine } from "./auto-compaction.js";
@@ -427,10 +427,27 @@ export function renderHarnessWidget(pi: ExtensionAPI, state: HarnessRuntimeState
   });
 }
 
+type PiToolInfo = ReturnType<ExtensionAPI["getAllTools"]>[number];
+
+function isZobInternalTool(tool: PiToolInfo): boolean {
+  const path = tool.sourceInfo.path.replace(/\\/g, "/");
+  return path.includes("/.pi/extensions/zob-harness/") || path.includes("/.pi/extensions/zob-switch/");
+}
+
+function isExternalPackageTool(tool: PiToolInfo): boolean {
+  return tool.sourceInfo.source !== "builtin" && tool.sourceInfo.source !== "sdk" && !isZobInternalTool(tool);
+}
+
+function uniqueToolNames(names: string[]): string[] {
+  return [...new Set(names)];
+}
+
 export function applyMode(pi: ExtensionAPI, state: HarnessRuntimeState, ctx: ExtensionContext, mode: ModeName, persist = true): void {
   state.activeMode = mode;
-  const available = new Set(pi.getAllTools().map((tool) => tool.name));
-  const activeTools = mode === "vanilla" ? [...available] : MODE_TOOLS[mode].filter((tool) => available.has(tool));
+  const allTools = pi.getAllTools();
+  const available = new Set(allTools.map((tool) => tool.name));
+  const externalPackageTools = allTools.filter(isExternalPackageTool).map((tool) => tool.name);
+  const activeTools = mode === "vanilla" ? [...available] : uniqueToolNames([...MODE_TOOLS[mode].filter((tool) => available.has(tool)), ...externalPackageTools]);
   pi.setActiveTools(activeTools);
   if (persist) pi.appendEntry("zob-mode-state", { mode, timestamp: new Date().toISOString() });
   ctx.ui.setStatus("zob-mode", ctx.ui.theme.fg("accent", `zob:${mode}`));

package/.pi/extensions/zob-harness/src/runtime/zobHarness.ts

@@ -12,7 +12,7 @@ import { registerMissionControlTools } from "./tools-mission-control.js";
 import { registerFactoryTools } from "./tools-factory.js";
 import { registerProjectDnaTools } from "./tools-project-dna.js";
 import { registerOrchestrationTools } from "./tools-orchestration.js";
-import { registerGoalRuntimeEvents, registerGoalRuntimeTools } from "../goal-runtime.js";
+import { registerGoalRuntimeEvents, registerGoalRuntimeTools } from "./goal-runtime.js";
 import { registerGoalRoomTools } from "./tools-goal-room.js";
 import { registerGovernedRequestTools } from "./tools-governed-requests.js";
 import { registerWorkspaceClaimTools } from "./tools-workspace-claims.js";

package/.pi/extensions/zob-harness/src/types.ts

@@ -1,4 +1,4 @@
-import type { ChildChangedPathRef, ModeName } from "./types/core.js";
+import type { ChildChangedPathRef, ModeName } from "./core/types/core.js";
 
 export type {
   AgentScope,
@@ -9,7 +9,7 @@ export type {
   JsonEvent,
   ModeName,
   TextBlock,
-} from "./types/core.js";
+} from "./core/types/core.js";
 
 export interface DamageRule {
   pattern: string;

package/.pi/extensions/zob-switch/AGENTS.md

@@ -0,0 +1,9 @@
+# zob-switch Extension Guardrails
+
+- This folder owns the `/zob` Pi switch extension only.
+- Keep `.pi/extensions/zob-switch/index.ts` as the stable Pi entrypoint and preserve its default export.
+- Split-only refactors are allowed; do not change `/zob` behavior, command registration, aliases/autocomplete behavior, messages, settings paths, snapshot paths, schemas, defaults, or sync/async behavior.
+- Use NodeNext relative imports with `.js` suffix.
+- Use `import type` for type-only imports.
+- No file under `src/` may import from `index.ts`.
+- Do not touch secrets, generated/vendor folders, logs, sessions, reports, or unrelated extensions from this package.

package/.pi/extensions/zob-switch/index.ts

@@ -1,134 +1,22 @@
 import { existsSync } from "node:fs";
-import { mkdir, readFile, writeFile } from "node:fs/promises";
-import { dirname, join } from "node:path";
+import { join } from "node:path";
 
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import type { AutocompleteItem } from "@earendil-works/pi-tui";
 
-const SETTINGS_PATH = join(".pi", "settings.json");
-const SNAPSHOT_PATH = join(".pi", "tmp", "zob-switch", "settings-snapshot.json");
-const SWITCH_EXTENSION = "extensions/zob-switch/index.ts";
-const HARNESS_EXTENSION = "extensions/zob-harness/index.ts";
-const ZOB_PROMPTS = "prompts";
-const ZOB_SKILLS = "skills";
-
-type JsonObject = Record<string, unknown>;
-
-type Snapshot = {
-  schema: "zob.harness-switch.settings-snapshot.v1";
-  savedAt: string;
-  settings: JsonObject;
-};
-
-function isObject(value: unknown): value is JsonObject {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
-function asStringArray(value: unknown): string[] {
-  return Array.isArray(value) ? value.filter((entry): entry is string => typeof entry === "string") : [];
-}
-
-function uniqueWithRequiredFirst(values: string[], requiredFirst: string[]): string[] {
-  const result: string[] = [];
-  for (const value of [...requiredFirst, ...values]) {
-    if (!result.includes(value)) result.push(value);
-  }
-  return result;
-}
-
-function withoutValues(values: string[], remove: string[]): string[] {
-  return values.filter((value) => !remove.includes(value));
-}
-
-function hasValue(settings: JsonObject, key: "extensions" | "prompts" | "skills", value: string): boolean {
-  return asStringArray(settings[key]).includes(value);
-}
-
-async function readSettings(cwd: string): Promise<JsonObject> {
-  const raw = await readFile(join(cwd, SETTINGS_PATH), "utf8");
-  const parsed = JSON.parse(raw) as unknown;
-  if (!isObject(parsed)) throw new Error(`${SETTINGS_PATH} must contain a JSON object`);
-  return parsed;
-}
+import { argumentCompletions } from "./src/autocomplete.js";
+import { HARNESS_EXTENSION, SETTINGS_PATH } from "./src/paths.js";
+import { readSettings, writeSettings } from "./src/settings.js";
+import type { JsonObject } from "./src/settings.js";
+import { readSnapshot, writeSnapshot } from "./src/snapshot.js";
+import type { Snapshot } from "./src/snapshot.js";
+import { buildOffSettings, buildOnSettings, hasValue, statusFor } from "./src/state.js";
 
-async function writeSettings(cwd: string, settings: JsonObject): Promise<void> {
-  await writeFile(join(cwd, SETTINGS_PATH), `${JSON.stringify(settings, null, 2)}\n`, "utf8");
-}
-
-async function writeSnapshot(cwd: string, settings: JsonObject): Promise<void> {
-  const snapshot: Snapshot = {
-    schema: "zob.harness-switch.settings-snapshot.v1",
-    savedAt: new Date().toISOString(),
-    settings,
-  };
-  const snapshotPath = join(cwd, SNAPSHOT_PATH);
-  await mkdir(dirname(snapshotPath), { recursive: true });
-  await writeFile(snapshotPath, `${JSON.stringify(snapshot, null, 2)}\n`, "utf8");
-}
-
-async function readSnapshot(cwd: string): Promise<Snapshot | null> {
-  const snapshotPath = join(cwd, SNAPSHOT_PATH);
-  if (!existsSync(snapshotPath)) return null;
-  const parsed = JSON.parse(await readFile(snapshotPath, "utf8")) as unknown;
-  if (!isObject(parsed) || parsed.schema !== "zob.harness-switch.settings-snapshot.v1" || !isObject(parsed.settings)) {
-    throw new Error(`${SNAPSHOT_PATH} is not a valid ZOB switch snapshot`);
-  }
-  return parsed as Snapshot;
-}
+const SNAPSHOT_PATH = join(".pi", "tmp", "zob-switch", "settings-snapshot.json");
 
 function shouldWriteOffSnapshot(current: JsonObject, snapshot: Snapshot | null): boolean {
   return snapshot === null || hasValue(current, "extensions", HARNESS_EXTENSION);
 }
 
-function buildOffSettings(current: JsonObject): JsonObject {
-  return {
-    ...current,
-    extensions: uniqueWithRequiredFirst(withoutValues(asStringArray(current.extensions), [HARNESS_EXTENSION]), [SWITCH_EXTENSION]),
-    prompts: withoutValues(asStringArray(current.prompts), [ZOB_PROMPTS]),
-    skills: withoutValues(asStringArray(current.skills), [ZOB_SKILLS]),
-  };
-}
-
-function buildOnSettings(base: JsonObject, usedSnapshot: boolean): JsonObject {
-  return {
-    ...base,
-    extensions: uniqueWithRequiredFirst(asStringArray(base.extensions), [SWITCH_EXTENSION, HARNESS_EXTENSION]),
-    prompts: usedSnapshot ? asStringArray(base.prompts) : uniqueWithRequiredFirst(asStringArray(base.prompts), [ZOB_PROMPTS]),
-    skills: usedSnapshot ? asStringArray(base.skills) : uniqueWithRequiredFirst(asStringArray(base.skills), [ZOB_SKILLS]),
-  };
-}
-
-function statusFor(settings: JsonObject, snapshotPresent: boolean): string {
-  const switchConfigured = hasValue(settings, "extensions", SWITCH_EXTENSION);
-  const harnessConfigured = hasValue(settings, "extensions", HARNESS_EXTENSION);
-  const promptsConfigured = hasValue(settings, "prompts", ZOB_PROMPTS);
-  const skillsConfigured = hasValue(settings, "skills", ZOB_SKILLS);
-  const state = switchConfigured && harnessConfigured && promptsConfigured && skillsConfigured
-    ? "on"
-    : switchConfigured && !harnessConfigured && !promptsConfigured && !skillsConfigured
-      ? "off"
-      : "partial";
-  return [
-    `ZOB Harness switch: ${state}`,
-    `switch extension: ${switchConfigured ? "configured" : "missing"}`,
-    `harness extension: ${harnessConfigured ? "configured" : "missing"}`,
-    `prompts: ${promptsConfigured ? "configured" : "missing"}`,
-    `skills: ${skillsConfigured ? "configured" : "missing"}`,
-    `snapshot: ${snapshotPresent ? "present" : "missing"}`,
-  ].join("\n");
-}
-
-function argumentCompletions(prefix: string): AutocompleteItem[] | null {
-  const query = prefix.trim().toLowerCase();
-  const items: AutocompleteItem[] = [
-    { value: "on", label: "on", description: "restore ZOB Harness from snapshot/defaults and reload" },
-    { value: "off", label: "off", description: "snapshot settings, unload ZOB Harness resources, and reload" },
-    { value: "status", label: "status", description: "show switch/harness/prompts/skills/snapshot state" },
-  ];
-  const filtered = query ? items.filter((item) => item.value.startsWith(query)) : items;
-  return filtered.length > 0 ? filtered : null;
-}
-
 export default function zobSwitch(pi: ExtensionAPI): void {
   pi.registerCommand("zob", {
     description: "Switch ZOB Harness on/off or show status: /zob on|off|status",

package/.pi/extensions/zob-switch/src/AGENTS.md

@@ -0,0 +1,8 @@
+# zob-switch src Guardrails
+
+- Modules here are sidecars for `.pi/extensions/zob-switch/index.ts`.
+- Move code only; do not rewrite logic, optimize, reorder behavior, rename helpers for behavior changes, or alter strings/schemas/paths.
+- Preserve `/zob` command behavior exactly, including settings and snapshot semantics.
+- Use NodeNext relative imports with `.js` suffix.
+- Use `import type` for type-only imports.
+- Never import from `../index.ts` or any `index.ts` entrypoint.

package/.pi/extensions/zob-switch/src/autocomplete.ts

@@ -0,0 +1,12 @@
+import type { AutocompleteItem } from "@earendil-works/pi-tui";
+
+export function argumentCompletions(prefix: string): AutocompleteItem[] | null {
+  const query = prefix.trim().toLowerCase();
+  const items: AutocompleteItem[] = [
+    { value: "on", label: "on", description: "restore ZOB Harness from snapshot/defaults and reload" },
+    { value: "off", label: "off", description: "snapshot settings, unload ZOB Harness resources, and reload" },
+    { value: "status", label: "status", description: "show switch/harness/prompts/skills/snapshot state" },
+  ];
+  const filtered = query ? items.filter((item) => item.value.startsWith(query)) : items;
+  return filtered.length > 0 ? filtered : null;
+}

package/.pi/extensions/zob-switch/src/paths.ts

@@ -0,0 +1,8 @@
+import { join } from "node:path";
+
+export const SETTINGS_PATH = join(".pi", "settings.json");
+export const SNAPSHOT_PATH = join(".pi", "tmp", "zob-switch", "settings-snapshot.json");
+export const SWITCH_EXTENSION = "extensions/zob-switch/index.ts";
+export const HARNESS_EXTENSION = "extensions/zob-harness/index.ts";
+export const ZOB_PROMPTS = "prompts";
+export const ZOB_SKILLS = "skills";

package/.pi/extensions/zob-switch/src/settings.ts

@@ -0,0 +1,25 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+
+import { SETTINGS_PATH } from "./paths.js";
+
+export type JsonObject = Record<string, unknown>;
+
+export function isObject(value: unknown): value is JsonObject {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+export function asStringArray(value: unknown): string[] {
+  return Array.isArray(value) ? value.filter((entry): entry is string => typeof entry === "string") : [];
+}
+
+export async function readSettings(cwd: string): Promise<JsonObject> {
+  const raw = await readFile(join(cwd, SETTINGS_PATH), "utf8");
+  const parsed = JSON.parse(raw) as unknown;
+  if (!isObject(parsed)) throw new Error(`${SETTINGS_PATH} must contain a JSON object`);
+  return parsed;
+}
+
+export async function writeSettings(cwd: string, settings: JsonObject): Promise<void> {
+  await writeFile(join(cwd, SETTINGS_PATH), `${JSON.stringify(settings, null, 2)}\n`, "utf8");
+}

package/.pi/extensions/zob-switch/src/snapshot.ts

@@ -0,0 +1,34 @@
+import { existsSync } from "node:fs";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+
+import { SNAPSHOT_PATH } from "./paths.js";
+import { isObject } from "./settings.js";
+import type { JsonObject } from "./settings.js";
+
+export type Snapshot = {
+  schema: "zob.harness-switch.settings-snapshot.v1";
+  savedAt: string;
+  settings: JsonObject;
+};
+
+export async function writeSnapshot(cwd: string, settings: JsonObject): Promise<void> {
+  const snapshot: Snapshot = {
+    schema: "zob.harness-switch.settings-snapshot.v1",
+    savedAt: new Date().toISOString(),
+    settings,
+  };
+  const snapshotPath = join(cwd, SNAPSHOT_PATH);
+  await mkdir(dirname(snapshotPath), { recursive: true });
+  await writeFile(snapshotPath, `${JSON.stringify(snapshot, null, 2)}\n`, "utf8");
+}
+
+export async function readSnapshot(cwd: string): Promise<Snapshot | null> {
+  const snapshotPath = join(cwd, SNAPSHOT_PATH);
+  if (!existsSync(snapshotPath)) return null;
+  const parsed = JSON.parse(await readFile(snapshotPath, "utf8")) as unknown;
+  if (!isObject(parsed) || parsed.schema !== "zob.harness-switch.settings-snapshot.v1" || !isObject(parsed.settings)) {
+    throw new Error(`${SNAPSHOT_PATH} is not a valid ZOB switch snapshot`);
+  }
+  return parsed as Snapshot;
+}

package/.pi/extensions/zob-switch/src/state.ts

@@ -0,0 +1,57 @@
+import { HARNESS_EXTENSION, SWITCH_EXTENSION, ZOB_PROMPTS, ZOB_SKILLS } from "./paths.js";
+import { asStringArray } from "./settings.js";
+import type { JsonObject } from "./settings.js";
+
+function uniqueWithRequiredFirst(values: string[], requiredFirst: string[]): string[] {
+  const result: string[] = [];
+  for (const value of [...requiredFirst, ...values]) {
+    if (!result.includes(value)) result.push(value);
+  }
+  return result;
+}
+
+function withoutValues(values: string[], remove: string[]): string[] {
+  return values.filter((value) => !remove.includes(value));
+}
+
+export function hasValue(settings: JsonObject, key: "extensions" | "prompts" | "skills", value: string): boolean {
+  return asStringArray(settings[key]).includes(value);
+}
+
+export function buildOffSettings(current: JsonObject): JsonObject {
+  return {
+    ...current,
+    extensions: uniqueWithRequiredFirst(withoutValues(asStringArray(current.extensions), [HARNESS_EXTENSION]), [SWITCH_EXTENSION]),
+    prompts: withoutValues(asStringArray(current.prompts), [ZOB_PROMPTS]),
+    skills: withoutValues(asStringArray(current.skills), [ZOB_SKILLS]),
+  };
+}
+
+export function buildOnSettings(base: JsonObject, usedSnapshot: boolean): JsonObject {
+  return {
+    ...base,
+    extensions: uniqueWithRequiredFirst(asStringArray(base.extensions), [SWITCH_EXTENSION, HARNESS_EXTENSION]),
+    prompts: usedSnapshot ? asStringArray(base.prompts) : uniqueWithRequiredFirst(asStringArray(base.prompts), [ZOB_PROMPTS]),
+    skills: usedSnapshot ? asStringArray(base.skills) : uniqueWithRequiredFirst(asStringArray(base.skills), [ZOB_SKILLS]),
+  };
+}
+
+export function statusFor(settings: JsonObject, snapshotPresent: boolean): string {
+  const switchConfigured = hasValue(settings, "extensions", SWITCH_EXTENSION);
+  const harnessConfigured = hasValue(settings, "extensions", HARNESS_EXTENSION);
+  const promptsConfigured = hasValue(settings, "prompts", ZOB_PROMPTS);
+  const skillsConfigured = hasValue(settings, "skills", ZOB_SKILLS);
+  const state = switchConfigured && harnessConfigured && promptsConfigured && skillsConfigured
+    ? "on"
+    : switchConfigured && !harnessConfigured && !promptsConfigured && !skillsConfigured
+      ? "off"
+      : "partial";
+  return [
+    `ZOB Harness switch: ${state}`,
+    `switch extension: ${switchConfigured ? "configured" : "missing"}`,
+    `harness extension: ${harnessConfigured ? "configured" : "missing"}`,
+    `prompts: ${promptsConfigured ? "configured" : "missing"}`,
+    `skills: ${skillsConfigured ? "configured" : "missing"}`,
+    `snapshot: ${snapshotPresent ? "present" : "missing"}`,
+  ].join("\n");
+}

package/.pi/factories/agentic-spec-team/README.md

@@ -0,0 +1,35 @@
+# Agentic Spec Team Factory
+
+Status: **v1 scaffold**.
+
+This factory describes the repeatable checkpoint backbone for the Agentic Spec Team workflow. The actual v1 launch surface is `scripts/spec-run.mjs` plus run-scoped ZTeam agents. The factory keeps the process evidence-first, human-question-gated, and oracle-reviewed.
+
+## Safe entrypoints
+
+```bash
+npm run spec-run -- init --mission "..." --source docs/ --source data/export.csv
+npm run spec-run:auto-pilot -- --mission-file specs/mission.md --source docs/ --source mockups/
+```
+
+## What it does
+
+- Defines map/reduce/validate stages for source intake, data/domain/UX analysis, spec synthesis, BDD, handoff, and oracle review.
+- Requires traceability from source/answer/assumption to requirement, criteria, task, and oracle check.
+- Treats raw sources as `citation_only` or `context_only` until explicitly approved otherwise.
+- Blocks completion on open blocking questions.
+- Requires final oracle PASS with `no_ship=false`.
+
+## What it does not do in v1
+
+- No runtime `/spec-run` extension command.
+- No external durable write/import/sync.
+- No automatic answer invention for business decisions.
+- No closing tmux on timeout/WARN/FAIL/no_ship=true.
+
+## Local validators
+
+```bash
+node scripts/spec-run.mjs validate <run_id>
+node scripts/agentic-spec-team/validate-run.mjs <run_id>
+node scripts/agentic-spec-team/validate-traceability.mjs <run_id>
+```

package/.pi/factories/agentic-spec-team/batch-manifest.json

@@ -0,0 +1,11 @@
+{
+  "factory": "agentic-spec-team",
+  "mode": "batch",
+  "items": [
+    {
+      "id": "agentic-spec-docs-batch",
+      "path": "docs/",
+      "mission": "Analyze ZOB docs as source material for a detailed agentic spec team operating model."
+    }
+  ]
+}

package/.pi/factories/agentic-spec-team/example-agentic-spec-manifest.json

@@ -0,0 +1,19 @@
+{
+  "schema": "zob.agentic-spec-manifest.v1",
+  "name": "billing-redesign",
+  "mission": "Produce a detailed, testable billing redesign implementation spec from approved docs, data exports, mockups, and owner notes.",
+  "sources": [
+    { "path": "docs/billing-brief.md", "type": "doc", "policy": "citation_only" },
+    { "path": "data/billing-export.csv", "type": "data", "policy": "citation_only" },
+    { "path": "mockups/billing-flow/", "type": "mockups", "policy": "context_only" }
+  ],
+  "human_question_policy": {
+    "interlocutor": "spec-chief",
+    "blocking_questions_stop_auto_pilot": true
+  },
+  "completion_gate": {
+    "traceability_required": true,
+    "oracle_required": true,
+    "no_ship_must_be_false": true
+  }
+}

package/.pi/factories/agentic-spec-team/factory.json

@@ -0,0 +1,98 @@
+{
+  "name": "agentic-spec-team",
+  "version": "0.1.0",
+  "description": "Evidence-first ZOB workflow for producing detailed implementation specs from missions plus docs/data/mockups through a run-scoped agent team.",
+  "status": "v1-scaffold",
+  "autoPromotion": false,
+  "manualPromotionRequired": true,
+  "defaultMode": "smoke",
+  "agenticModel": {
+    "controlPlane": "spec-chief-led-zteam-plus-deterministic-cli",
+    "runtimeExtensionV1": false,
+    "humanInterlocutor": "spec-chief",
+    "traceabilityRequired": true,
+    "oracleRequired": true
+  },
+  "requiredStages": [
+    "manifest_loaded",
+    "source_registered",
+    "analysis_ready",
+    "clarification_closed",
+    "spec_synthesized",
+    "acceptance_ready",
+    "workgraph_ready",
+    "oracle_passed",
+    "sentinel"
+  ],
+  "expectedArtifacts": [
+    "run-manifest.json",
+    "source-register.json",
+    "source-register.md",
+    "questions.md",
+    "answers.md",
+    "validation/traceability-matrix.json",
+    "validation/traceability-matrix.md",
+    "spec/mission-spec.md",
+    "validation/acceptance-criteria.md",
+    "handoff/workgraph.md",
+    "oracle/final-oracle-review.json",
+    "final-report.json",
+    "status.json"
+  ],
+  "noShipBlockers": [
+    "secret-like source path or sensitive raw data persisted without approval",
+    "blocking human question open",
+    "requirement without source, answer, assumption, or decision support",
+    "acceptance criterion not mapped to requirement",
+    "task not mapped to acceptance criterion",
+    "contradiction hidden without decision",
+    "final oracle missing or no_ship=true",
+    "auto-pilot closes tmux on timeout/WARN/FAIL/no_ship=true"
+  ],
+  "stages": [
+    {
+      "name": "source-intake",
+      "type": "map",
+      "agent": "explore",
+      "outputContract": "explore.v1",
+      "requiredTools": ["read", "grep", "find", "ls"],
+      "expectedOutcome": "Inventory approved sources, sensitivity, freshness, owners, contradictions, and open questions with citations.",
+      "mustDo": ["Use only explicit sources from run-manifest.json.", "Assign stable source IDs.", "Flag secret-like or sensitive sources.", "Write source quality gaps."],
+      "mustNotDo": ["No broad filesystem scan.", "No secrets.", "No source mutation.", "No external durable writes."],
+      "context": "Agentic Spec Team run {run.id}; source intake stage."
+    },
+    {
+      "name": "specialized-analysis",
+      "type": "map",
+      "agent": "explore",
+      "outputContract": "explore.v1",
+      "requiredTools": ["read", "grep", "find", "ls"],
+      "expectedOutcome": "Produce data/domain/UX analysis artifacts and candidate traceability rows.",
+      "mustDo": ["Cite source refs for each finding.", "Separate facts from assumptions.", "Propose questions to spec-chief when blocked."],
+      "mustNotDo": ["No invented business decisions.", "No direct human questions except through spec-chief.", "No edits outside the run directory."],
+      "context": "Agentic Spec Team run {run.id}; data/domain/UX analysis."
+    },
+    {
+      "name": "spec-synthesis",
+      "type": "reduce",
+      "agent": "specifier",
+      "outputContract": "spec.v1",
+      "requiredTools": ["read", "grep", "find", "ls"],
+      "expectedOutcome": "Synthesize mission spec, requirements, acceptance criteria, BDD, and workgraph from cited analysis artifacts.",
+      "mustDo": ["Every requirement must be traceable.", "List non-functional requirements and edge cases.", "Map implementation tasks to acceptance criteria."],
+      "mustNotDo": ["No unsupported requirements.", "No hidden contradictions.", "No open blocking questions."],
+      "context": "Agentic Spec Team run {run.id}; spec synthesis."
+    },
+    {
+      "name": "oracle-validation",
+      "type": "validate",
+      "agent": "oracle",
+      "outputContract": "oracle.v1",
+      "requiredTools": ["read", "grep", "find", "ls"],
+      "expectedOutcome": "Validate source-to-requirement-to-task traceability, question closure, sensitive data posture, and final no-ship status.",
+      "mustDo": ["Fail if traceability is incomplete.", "Fail if blocking questions remain open.", "Fail if final-report PASS/no_ship=false is unsupported."],
+      "mustNotDo": ["No patches.", "No commits.", "No external writes.", "No approval of unsupported specs."],
+      "context": "Agentic Spec Team run {run.id}; final oracle gate."
+    }
+  ]
+}

package/.pi/factories/agentic-spec-team/pilot-manifest.json

@@ -0,0 +1,11 @@
+{
+  "factory": "agentic-spec-team",
+  "mode": "pilot",
+  "items": [
+    {
+      "id": "agentic-spec-readme-pilot",
+      "path": "README.md",
+      "mission": "Produce a cited internal spec for how the Agentic Spec Team should be used from this repository."
+    }
+  ]
+}

package/.pi/factories/agentic-spec-team/schemas/final-report.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "zob.agentic-spec.final-report.schema.v1",
+  "type": "object",
+  "required": ["schema", "run_id", "status", "no_ship", "verdict"],
+  "properties": {
+    "schema": { "const": "agentic-spec.final-report.v1" },
+    "run_id": { "type": "string", "minLength": 1 },
+    "status": { "enum": ["pass", "blocked", "fail", "warn"] },
+    "verdict": { "enum": ["PASS", "WARN", "FAIL"] },
+    "no_ship": { "type": "boolean" },
+    "evidence_refs": { "type": "array", "items": { "type": "string" } },
+    "blocking_issues": { "type": "array", "items": { "type": "string" } }
+  }
+}

package/.pi/factories/agentic-spec-team/schemas/manifest.schema.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "zob.agentic-spec.manifest.schema.v1",
+  "type": "object",
+  "required": ["schema", "name", "mission", "sources", "completion_gate"],
+  "properties": {
+    "schema": { "const": "zob.agentic-spec-manifest.v1" },
+    "name": { "type": "string", "minLength": 1 },
+    "mission": { "type": "string", "minLength": 1 },
+    "sources": { "type": "array", "minItems": 1, "items": { "type": "object", "required": ["path"], "properties": { "path": { "type": "string", "minLength": 1 }, "type": { "type": "string" }, "policy": { "enum": ["citation_only", "context_only", "safe_to_copy"] } } } },
+    "human_question_policy": { "type": "object" },
+    "completion_gate": { "type": "object" }
+  }
+}

package/.pi/factories/agentic-spec-team/schemas/question.schema.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "zob.agentic-spec.question.schema.v1",
+  "type": "object",
+  "required": ["schema", "question_id", "status", "blocking", "question"],
+  "properties": {
+    "schema": { "const": "agentic-spec.question.v1" },
+    "question_id": { "type": "string", "pattern": "^Q-[0-9]{3,}$" },
+    "status": { "enum": ["open", "answered", "closed", "withdrawn"] },
+    "blocking": { "type": "boolean" },
+    "origin_agent": { "type": "string" },
+    "concerns": { "type": "array", "items": { "type": "string" } },
+    "source_refs": { "type": "array", "items": { "type": "string" } },
+    "question": { "type": "string", "minLength": 1 },
+    "options": { "type": "array" },
+    "recommended_option": { "type": ["string", "null"] }
+  }
+}

package/.pi/factories/agentic-spec-team/schemas/source-register.schema.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "zob.agentic-spec.source-register.schema.v1",
+  "type": "object",
+  "required": ["schema", "run_id", "sources"],
+  "properties": {
+    "schema": { "const": "agentic-spec.source-register.v1" },
+    "run_id": { "type": "string", "minLength": 1 },
+    "sources": { "type": "array", "items": { "type": "object", "required": ["source_id", "path", "exists", "policy"], "properties": { "source_id": { "type": "string" }, "path": { "type": "string" }, "exists": { "type": "boolean" }, "kind": { "type": "string" }, "policy": { "type": "string" }, "sensitivity": { "type": "string" } } } }
+  }
+}