oh-my-pm 1.0.0

package/dist/utils/manifest.d.ts

@@ -0,0 +1,60 @@
+export declare const MANIFEST_RELATIVE_PATH = ".parkops/pm_manifest.json";
+export declare const MANIFEST_SCHEMA_RELATIVE_PATH = ".parkops/schemas/pm-manifest-schema.json";
+export declare const MANIFEST_STATUSES: readonly ["discovery", "designed", "approved", "in_development", "blocked", "completed"];
+export declare const TASK_STATUSES: readonly ["pending", "in_progress", "blocked", "completed"];
+export type ManifestStatus = (typeof MANIFEST_STATUSES)[number];
+export type TaskStatus = (typeof TASK_STATUSES)[number];
+export type ManifestTask = {
+    readonly id: string;
+    readonly depends_on: readonly string[];
+    readonly spec_reference: string;
+    readonly description: string;
+    readonly status: TaskStatus;
+    readonly verification_criteria: readonly string[];
+    readonly assigned_to: string;
+};
+export type Manifest = {
+    readonly $schema: string;
+    readonly project_metadata: {
+        readonly name: string;
+        readonly blueprint_version: string;
+        readonly status: ManifestStatus;
+        readonly generated_by: string;
+        readonly generated_at: string;
+    };
+    readonly product_blueprints: {
+        readonly prd: string;
+        readonly trd: string;
+        readonly db_schema: string;
+        readonly ui_flows: readonly string[];
+        readonly execution_plan: string;
+    };
+    readonly execution_dag: {
+        readonly version: string;
+        readonly tasks: readonly ManifestTask[];
+    };
+    readonly feedback_channel: {
+        readonly blockers: readonly Blocker[];
+        readonly decisions: readonly Decision[];
+    };
+};
+export type Blocker = {
+    readonly id: string;
+    readonly raised_by: "dev-harness" | "oh-my-pm";
+    readonly description: string;
+    readonly proposed_solutions: readonly string[];
+    readonly status: "open" | "resolved";
+    readonly resolution: string;
+};
+export type Decision = {
+    readonly id: string;
+    readonly description: string;
+    readonly rationale: string;
+    readonly alternatives_considered: readonly string[];
+};
+export declare function buildInitialManifest(projectName: string, generatedAt: string): Manifest;
+export declare function writeManifest(projectRoot: string, manifest: Manifest): Promise<string>;
+export declare function readManifest(projectRoot: string): Promise<unknown>;
+export declare function manifestExists(projectRoot: string): Promise<boolean>;
+export declare function withStatus(manifest: Manifest, status: ManifestStatus): Manifest;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/utils/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/utils/manifest.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,sBAAsB,8BAA8B,CAAA;AACjE,eAAO,MAAM,6BAA6B,6CAA6C,CAAA;AAEvF,eAAO,MAAM,iBAAiB,0FAOpB,CAAA;AAEV,eAAO,MAAM,aAAa,6DAA8D,CAAA;AAExF,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAA;AAC/D,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAA;AAEvD,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;IACtC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;IAC3B,QAAQ,CAAC,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAA;IACjD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,gBAAgB,EAAE;QACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;QAClC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;QAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;QAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;KAC9B,CAAA;IACD,QAAQ,CAAC,kBAAkB,EAAE;QAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;QACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;QACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;QAC1B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;QACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;KAChC,CAAA;IACD,QAAQ,CAAC,aAAa,EAAE;QACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;QACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAA;KACxC,CAAA;IACD,QAAQ,CAAC,gBAAgB,EAAE;QACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAA;QACrC,QAAQ,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAA;KACxC,CAAA;CACF,CAAA;AAED,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,SAAS,EAAE,aAAa,GAAG,UAAU,CAAA;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAA;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAA;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,uBAAuB,EAAE,SAAS,MAAM,EAAE,CAAA;CACpD,CAAA;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,QAAQ,CAoBvF;AAED,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAK5F;AAED,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAKxE;AAED,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE1E;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,GAAG,QAAQ,CAc/E"}

package/dist/utils/manifest.js

@@ -0,0 +1,65 @@
+import fs from "fs-extra";
+import path from "node:path";
+export const MANIFEST_RELATIVE_PATH = ".parkops/pm_manifest.json";
+export const MANIFEST_SCHEMA_RELATIVE_PATH = ".parkops/schemas/pm-manifest-schema.json";
+export const MANIFEST_STATUSES = [
+    "discovery",
+    "designed",
+    "approved",
+    "in_development",
+    "blocked",
+    "completed",
+];
+export const TASK_STATUSES = ["pending", "in_progress", "blocked", "completed"];
+export function buildInitialManifest(projectName, generatedAt) {
+    return {
+        $schema: "./schemas/pm-manifest-schema.json",
+        project_metadata: {
+            name: projectName,
+            blueprint_version: "1.0.0",
+            status: "discovery",
+            generated_by: "oh-my-pm v1.0.0",
+            generated_at: generatedAt,
+        },
+        product_blueprints: {
+            prd: "docs/prd.md",
+            trd: "docs/trd.md",
+            db_schema: "docs/db-schema.md",
+            ui_flows: ["docs/flows/main-flow.md"],
+            execution_plan: "docs/execution-plan.md",
+        },
+        execution_dag: { version: "1.0.0", tasks: [] },
+        feedback_channel: { blockers: [], decisions: [] },
+    };
+}
+export async function writeManifest(projectRoot, manifest) {
+    const manifestPath = path.join(projectRoot, MANIFEST_RELATIVE_PATH);
+    await fs.ensureDir(path.dirname(manifestPath));
+    await fs.writeJson(manifestPath, manifest, { spaces: 2 });
+    return manifestPath;
+}
+export async function readManifest(projectRoot) {
+    const manifestPath = path.join(projectRoot, MANIFEST_RELATIVE_PATH);
+    const raw = await fs.readFile(manifestPath, "utf8");
+    const parsed = JSON.parse(raw);
+    return parsed;
+}
+export async function manifestExists(projectRoot) {
+    return fs.pathExists(path.join(projectRoot, MANIFEST_RELATIVE_PATH));
+}
+export function withStatus(manifest, status) {
+    return {
+        $schema: manifest.$schema,
+        project_metadata: {
+            name: manifest.project_metadata.name,
+            blueprint_version: manifest.project_metadata.blueprint_version,
+            status,
+            generated_by: manifest.project_metadata.generated_by,
+            generated_at: manifest.project_metadata.generated_at,
+        },
+        product_blueprints: manifest.product_blueprints,
+        execution_dag: manifest.execution_dag,
+        feedback_channel: manifest.feedback_channel,
+    };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/utils/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/utils/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,UAAU,CAAA;AACzB,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,MAAM,CAAC,MAAM,sBAAsB,GAAG,2BAA2B,CAAA;AACjE,MAAM,CAAC,MAAM,6BAA6B,GAAG,0CAA0C,CAAA;AAEvF,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,WAAW;IACX,UAAU;IACV,UAAU;IACV,gBAAgB;IAChB,SAAS;IACT,WAAW;CACH,CAAA;AAEV,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,CAAU,CAAA;AAyDxF,MAAM,UAAU,oBAAoB,CAAC,WAAmB,EAAE,WAAmB;IAC3E,OAAO;QACL,OAAO,EAAE,mCAAmC;QAC5C,gBAAgB,EAAE;YAChB,IAAI,EAAE,WAAW;YACjB,iBAAiB,EAAE,OAAO;YAC1B,MAAM,EAAE,WAAW;YACnB,YAAY,EAAE,iBAAiB;YAC/B,YAAY,EAAE,WAAW;SAC1B;QACD,kBAAkB,EAAE;YAClB,GAAG,EAAE,aAAa;YAClB,GAAG,EAAE,aAAa;YAClB,SAAS,EAAE,mBAAmB;YAC9B,QAAQ,EAAE,CAAC,yBAAyB,CAAC;YACrC,cAAc,EAAE,wBAAwB;SACzC;QACD,aAAa,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;QAC9C,gBAAgB,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;KAClD,CAAA;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,WAAmB,EAAE,QAAkB;IACzE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,sBAAsB,CAAC,CAAA;IACnE,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAA;IAC9C,MAAM,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAA;IACzD,OAAO,YAAY,CAAA;AACrB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,WAAmB;IACpD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,sBAAsB,CAAC,CAAA;IACnE,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAA;IACnD,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACvC,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,WAAmB;IACtD,OAAO,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,sBAAsB,CAAC,CAAC,CAAA;AACtE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAkB,EAAE,MAAsB;IACnE,OAAO;QACL,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,gBAAgB,EAAE;YAChB,IAAI,EAAE,QAAQ,CAAC,gBAAgB,CAAC,IAAI;YACpC,iBAAiB,EAAE,QAAQ,CAAC,gBAAgB,CAAC,iBAAiB;YAC9D,MAAM;YACN,YAAY,EAAE,QAAQ,CAAC,gBAAgB,CAAC,YAAY;YACpD,YAAY,EAAE,QAAQ,CAAC,gBAAgB,CAAC,YAAY;SACrD;QACD,kBAAkB,EAAE,QAAQ,CAAC,kBAAkB;QAC/C,aAAa,EAAE,QAAQ,CAAC,aAAa;QACrC,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;KAC5C,CAAA;AACH,CAAC"}

package/dist/utils/validation.d.ts

@@ -0,0 +1,14 @@
+export type ValidationIssue = {
+    readonly code: string;
+    readonly message: string;
+    readonly path: string;
+};
+export type ValidationReport = {
+    readonly ok: boolean;
+    readonly issues: readonly ValidationIssue[];
+};
+export declare function validateManifestData(data: unknown): ValidationReport;
+export declare function validateManifestFile(manifestPath: string): Promise<ValidationReport>;
+export declare function checkMermaidSyntax(source: string): ValidationReport;
+export declare function checkReferencedFiles(projectRoot: string, references: readonly string[]): Promise<ValidationReport>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAA;CAC5C,CAAA;AA+GD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAWpE;AAED,wBAAsB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAI1F;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAKnE;AAED,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAOxH"}

package/dist/utils/validation.js

@@ -0,0 +1,137 @@
+import fs from "fs-extra";
+import path from "node:path";
+const VALID_PROJECT_STATUSES = new Set([
+    "discovery",
+    "designed",
+    "approved",
+    "in_development",
+    "blocked",
+    "completed",
+]);
+const VALID_TASK_STATUSES = new Set(["pending", "in_progress", "blocked", "completed"]);
+function issue(code, pathValue, message) {
+    return { code, path: pathValue, message };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function stringAt(record, key) {
+    const value = record[key];
+    return typeof value === "string" ? value : null;
+}
+function arrayAt(record, key) {
+    const value = record[key];
+    return Array.isArray(value) ? value : null;
+}
+function requireObject(record, key, issues, parent) {
+    const value = record[key];
+    if (isRecord(value))
+        return value;
+    issues.push(issue("required_object", `${parent}.${key}`, "Expected an object."));
+    return null;
+}
+function requireString(record, key, issues, parent) {
+    if (stringAt(record, key) === null) {
+        issues.push(issue("required_string", `${parent}.${key}`, "Expected a string."));
+    }
+}
+function validateMetadata(root, issues) {
+    const metadata = requireObject(root, "project_metadata", issues, "$");
+    if (metadata === null)
+        return;
+    for (const key of ["name", "blueprint_version", "generated_by", "generated_at"]) {
+        requireString(metadata, key, issues, "$.project_metadata");
+    }
+    const status = stringAt(metadata, "status");
+    if (status === null || !VALID_PROJECT_STATUSES.has(status)) {
+        issues.push(issue("invalid_status", "$.project_metadata.status", "Status is not part of the Oh My PM lifecycle."));
+    }
+}
+function validateBlueprints(root, issues) {
+    const blueprints = requireObject(root, "product_blueprints", issues, "$");
+    if (blueprints === null)
+        return;
+    for (const key of ["prd", "trd", "db_schema", "execution_plan"]) {
+        requireString(blueprints, key, issues, "$.product_blueprints");
+    }
+    const flows = arrayAt(blueprints, "ui_flows");
+    if (flows === null || flows.length === 0 || flows.some((entry) => typeof entry !== "string")) {
+        issues.push(issue("invalid_flows", "$.product_blueprints.ui_flows", "Expected at least one flow path string."));
+    }
+}
+function validateTask(task, index, issues) {
+    if (!isRecord(task)) {
+        issues.push(issue("invalid_task", `$.execution_dag.tasks[${index}]`, "Task must be an object."));
+        return;
+    }
+    for (const key of ["id", "spec_reference", "description", "assigned_to"]) {
+        requireString(task, key, issues, `$.execution_dag.tasks[${index}]`);
+    }
+    const status = stringAt(task, "status");
+    if (status === null || !VALID_TASK_STATUSES.has(status)) {
+        issues.push(issue("invalid_task_status", `$.execution_dag.tasks[${index}].status`, "Task status is invalid."));
+    }
+    const dependsOn = arrayAt(task, "depends_on");
+    if (dependsOn === null || dependsOn.some((entry) => typeof entry !== "string")) {
+        issues.push(issue("invalid_dependencies", `$.execution_dag.tasks[${index}].depends_on`, "Dependencies must be strings."));
+    }
+    const criteria = arrayAt(task, "verification_criteria");
+    if (criteria === null || criteria.length === 0 || criteria.some((entry) => typeof entry !== "string")) {
+        issues.push(issue("invalid_verification", `$.execution_dag.tasks[${index}].verification_criteria`, "Verification criteria must be non-empty strings."));
+    }
+}
+function validateDag(root, issues) {
+    const dag = requireObject(root, "execution_dag", issues, "$");
+    if (dag === null)
+        return;
+    requireString(dag, "version", issues, "$.execution_dag");
+    const tasks = arrayAt(dag, "tasks");
+    if (tasks === null) {
+        issues.push(issue("invalid_tasks", "$.execution_dag.tasks", "Expected a task array."));
+        return;
+    }
+    tasks.forEach((task, index) => validateTask(task, index, issues));
+}
+function validateFeedback(root, issues) {
+    const feedback = requireObject(root, "feedback_channel", issues, "$");
+    if (feedback === null)
+        return;
+    for (const key of ["blockers", "decisions"]) {
+        const value = arrayAt(feedback, key);
+        if (value === null)
+            issues.push(issue("invalid_feedback", `$.feedback_channel.${key}`, "Expected an array."));
+    }
+}
+export function validateManifestData(data) {
+    const issues = [];
+    if (!isRecord(data)) {
+        return { ok: false, issues: [issue("invalid_root", "$", "Manifest root must be an object.")] };
+    }
+    requireString(data, "$schema", issues, "$");
+    validateMetadata(data, issues);
+    validateBlueprints(data, issues);
+    validateDag(data, issues);
+    validateFeedback(data, issues);
+    return { ok: issues.length === 0, issues };
+}
+export async function validateManifestFile(manifestPath) {
+    const raw = await fs.readFile(manifestPath, "utf8");
+    const parsed = JSON.parse(raw);
+    return validateManifestData(parsed);
+}
+export function checkMermaidSyntax(source) {
+    const firstLine = source.split(/\r?\n/).find((line) => line.trim().length > 0);
+    const validPrefixes = ["flowchart", "graph", "sequenceDiagram", "stateDiagram", "erDiagram", "journey", "gantt", "classDiagram"];
+    const ok = firstLine !== undefined && validPrefixes.some((prefix) => firstLine.trim().startsWith(prefix));
+    return ok ? { ok: true, issues: [] } : { ok: false, issues: [issue("invalid_mermaid", "$", "Mermaid source must start with a supported diagram keyword.")] };
+}
+export async function checkReferencedFiles(projectRoot, references) {
+    const issues = [];
+    for (const reference of references) {
+        const exists = await fs.pathExists(path.join(projectRoot, reference));
+        if (!exists)
+            issues.push(issue("missing_reference", reference, "Referenced file does not exist."));
+    }
+    return { ok: issues.length === 0, issues };
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"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"}

package/docs/architecture.md

@@ -0,0 +1,54 @@
+# Oh My PM Architecture
+
+Oh My PM is a project-level Product Management harness that installs agent instructions and a manifest contract.
+
+## Components
+
+| Component | Responsibility |
+| --- | --- |
+| CLI | Installs templates, initializes `.parkops/`, validates manifests. |
+| OpenCode runtime plugin | Registers five PM agents through OpenCode `config.agent`. |
+| OpenCode templates | `SKILL.md` files for project-level routing and memory. |
+| Claude template | `CLAUDE.md` instructions for Task-based delegation. |
+| OpenAI template | `agents.py` with Agents SDK definitions and handoffs. |
+| Generic template | Portable Markdown instructions for any LLM. |
+| Manifest schema | Contract shape for Oh My PM and Dev-Harness. |
+
+## Pipeline
+
+```text
+User
+  -> JC discovery
+  -> Hammurabi PRD
+  -> DaVinci UX flows
+  -> Ada TRD and DB schema
+  -> SunTzu execution DAG
+  -> JC validation and user approval
+  -> Dev-Harness implementation
+```
+
+## Delegation model
+
+JC delegates by lane. Each specialist receives complete context and returns an artifact plus validation evidence. JC never performs specialist work unless the specialist lane is unavailable, and it records that exception as a decision.
+
+## Contract model
+
+`.parkops/pm_manifest.json` is the only cross-system contract. It references all blueprints and stores DAG tasks, decisions, and blockers.
+
+## Verification model
+
+Every stage has gates:
+
+- Artifact exists.
+- Artifact-specific validation passes.
+- Manifest references are consistent.
+- Blockers are open when ambiguity remains.
+- Approval is explicit before development starts.
+
+## Runtime plugin model
+
+`src/index.ts` exports the OpenCode plugin. The plugin loads `oh-my-pm.json` from the project root or `~/.config/opencode/`, resolves the active preset, then returns a config hook that merges JC, Hammurabi, DaVinci, Ada, and SunTzu into `opencodeConfig.agent`. The CLI entry point lives in `src/cli.ts` and is exposed as the `oh-my-pm` binary.
+
+## Configuration parity with oh-my-opencode-slim
+
+Oh My PM follows the same installation shape: `opencode.jsonc` registers the npm plugin, `oh-my-pm.json` stores plugin-specific presets, and `skills/oh-my-pm/SKILL.md` documents safe configuration changes. The domain differs: this package specializes in Software Product Management rather than general coding orchestration.

package/docs/dev-harness-bridge.md

@@ -0,0 +1,46 @@
+# Dev-Harness Bridge
+
+Dev-Harness consumes `.parkops/pm_manifest.json` as an implementation contract. There are no sync meetings or side-channel agreements. The manifest is the agreement.
+
+## Read path
+
+Dev-Harness reads:
+
+- `project_metadata.status` to determine whether work is approved.
+- `product_blueprints` to locate PRD, TRD, DB schema, UI flows, and execution plan.
+- `execution_dag.tasks` to schedule work by dependencies.
+- `feedback_channel.decisions` to preserve product and architecture decisions.
+
+## Write path
+
+Dev-Harness writes:
+
+- task `status` updates as work progresses.
+- blockers in `feedback_channel.blockers` when a task cannot proceed.
+- status `in_development`, `blocked`, or `completed` according to evidence.
+
+## Blocker format
+
+```json
+{
+  "id": "blocker_01",
+  "raised_by": "dev-harness",
+  "description": "The PRD requires offline payments but the TRD only defines Stripe checkout.",
+  "proposed_solutions": [
+    "Remove offline payments from scope",
+    "Add manual invoice flow to TRD and DAG"
+  ],
+  "status": "open",
+  "resolution": ""
+}
+```
+
+## PM response
+
+Oh My PM resolves blockers by updating the relevant product artifacts, adding decisions, changing verification criteria, and marking the blocker resolved with a rationale.
+
+## Integrity rules
+
+- Dev-Harness must not invent missing product requirements.
+- Oh My PM must not mark a blocker resolved without updating the artifact that caused the conflict.
+- Both systems must preserve ids so audit history remains stable.

package/docs/examples/example-manifest.json

@@ -0,0 +1,51 @@
+{
+  "$schema": "./schemas/pm-manifest-schema.json",
+  "project_metadata": {
+    "name": "team-launch-planner",
+    "blueprint_version": "1.0.0",
+    "status": "designed",
+    "generated_by": "oh-my-pm v1.0.0",
+    "generated_at": "2026-06-27T00:00:00.000Z"
+  },
+  "product_blueprints": {
+    "prd": "docs/prd.md",
+    "trd": "docs/trd.md",
+    "db_schema": "docs/db-schema.md",
+    "ui_flows": ["docs/flows/main-flow.md"],
+    "execution_plan": "docs/execution-plan.md"
+  },
+  "execution_dag": {
+    "version": "1.0.0",
+    "tasks": [
+      {
+        "id": "task_01_setup_project",
+        "depends_on": [],
+        "spec_reference": "PRD §3.1",
+        "description": "Create the application shell and persistence foundation.",
+        "status": "pending",
+        "verification_criteria": ["npm run build"],
+        "assigned_to": "dev-harness"
+      },
+      {
+        "id": "task_02_launch_plan_crud",
+        "depends_on": ["task_01_setup_project"],
+        "spec_reference": "PRD §5",
+        "description": "Implement create, read, update, and export for launch plans.",
+        "status": "pending",
+        "verification_criteria": ["npm test"],
+        "assigned_to": "dev-harness"
+      }
+    ]
+  },
+  "feedback_channel": {
+    "blockers": [],
+    "decisions": [
+      {
+        "id": "decision_01",
+        "description": "Use manifest-only PM and Dev coordination.",
+        "rationale": "The manifest gives both harnesses an auditable contract.",
+        "alternatives_considered": ["Chat handoff", "Meeting notes"]
+      }
+    ]
+  }
+}

package/docs/examples/example-prd.md

@@ -0,0 +1,47 @@
+# Product Requirements Document: Team Launch Planner
+
+## 1. Problem
+
+Small teams need a shared launch checklist that connects planning, ownership, dependencies, and release readiness without requiring a heavy project-management rollout.
+
+## 2. Users
+
+- Founder or product lead who defines launch goals.
+- Engineer who owns implementation tasks.
+- Designer who owns user-facing assets.
+- Operations lead who verifies release readiness.
+
+## 3. Scope
+
+### 3.1 In scope
+
+- Create a launch project.
+- Add milestones and owners.
+- Track dependencies between tasks.
+- Display readiness status.
+- Export the launch plan to Markdown.
+
+### 3.2 Out of scope
+
+- Real-time chat.
+- Billing.
+- Native mobile apps.
+
+## 4. User stories
+
+- As a product lead, I can create a launch plan so the team has a shared source of truth.
+- As an engineer, I can see blocked tasks so I know what cannot proceed.
+- As an operations lead, I can export the plan so stakeholders can review it asynchronously.
+
+## 5. Acceptance Criteria
+
+- A user can create a launch plan with title, date, owner, and milestones.
+- A user can mark a task as blocked with a reason.
+- The readiness view shows counts for pending, blocked, and completed tasks.
+- Markdown export includes milestones, owners, dependencies, and blockers.
+
+## 6. Metrics
+
+- Time from project creation to first exported plan.
+- Percentage of launches with zero unresolved blockers by release date.
+- Weekly active launch projects.

package/docs/installation.md

@@ -0,0 +1,75 @@
+# Installation Guide
+
+## Requirements
+
+- Node.js 20 or newer.
+- Bun available for `bunx oh-my-pm` usage.
+- A project directory where Oh My PM may write `.parkops/`, `.opencode/`, `AGENTS.md`, and optional platform files.
+
+## Install through bunx
+
+```bash
+bunx oh-my-pm init
+bunx oh-my-pm install
+```
+
+`init` creates `.parkops/pm_manifest.json` and copies the schema into `.parkops/schemas/pm-manifest-schema.json`.
+
+`install` writes the OpenCode runtime plugin configuration plus project skill files:
+
+```text
+.opencode/skills/jc/SKILL.md
+.opencode/skills/hammurabi/SKILL.md
+.opencode/skills/davinci/SKILL.md
+.opencode/skills/ada/SKILL.md
+.opencode/skills/suntzu/SKILL.md
+.opencode/skills/oh-my-pm/SKILL.md
+opencode.jsonc
+oh-my-pm.json
+AGENTS.md
+```
+
+
+## Global OpenCode install
+
+```bash
+bunx oh-my-pm install --global
+```
+
+This installs into `~/.config/opencode/`, merges `"oh-my-pm@latest"` into the existing `plugin` array, writes `oh-my-pm.json`, and installs all six skills under `skills/`. Existing files are backed up with `.oh-my-pm.backup`.
+
+## Optional platform outputs
+
+```bash
+bunx oh-my-pm install --claude
+bunx oh-my-pm install --openai
+bunx oh-my-pm install --generic
+bunx oh-my-pm install --all
+```
+
+These commands install `CLAUDE.md`, `agents.py`, or `OH_MY_PM_AGENTS.md` alongside the OpenCode runtime plugin configuration.
+
+## Template generation
+
+Use generation when you want to inspect templates before installing them:
+
+```bash
+bunx oh-my-pm generate opencode
+bunx oh-my-pm generate claude
+bunx oh-my-pm generate openai
+bunx oh-my-pm generate generic
+```
+
+Generated templates are written under `.parkops/generated/{platform}`.
+
+## Validation
+
+```bash
+bunx oh-my-pm validate
+```
+
+Validation checks the shape of `.parkops/pm_manifest.json`, lifecycle status, blueprint paths, DAG tasks, verification criteria, blockers, and decisions.
+
+## OpenCode runtime plugin
+
+The generated `opencode.jsonc` uses OpenCode's `plugin` and `agent` fields. The `plugin` entry loads `oh-my-pm@latest`; the runtime plugin injects the five PM agents through the OpenCode config hook. `oh-my-pm.json` stores model presets, mirroring the `oh-my-opencode-slim.json` pattern. The `agent` block remains available for project-level model overrides.

package/docs/lifecycle.md

@@ -0,0 +1,27 @@
+# Manifest Lifecycle
+
+Oh My PM and Dev-Harness coordinate through lifecycle status in `.parkops/pm_manifest.json`.
+
+## States
+
+| Status | Owner | Meaning | Exit condition |
+| --- | --- | --- | --- |
+| discovery | Oh My PM | JC is gathering product intent and constraints. | Product scope is clear enough to design. |
+| designed | Oh My PM | PRD, TRD, flows, DB schema, and execution DAG are drafted and validated. | User explicitly approves the design. |
+| approved | User and Oh My PM | The manifest is accepted as the development contract. | Dev-Harness starts implementation. |
+| in_development | Dev-Harness | Implementation is in progress against pending DAG tasks. | All tasks complete or a blocker appears. |
+| blocked | Dev-Harness or Oh My PM | A contradiction, missing dependency, or infeasible criterion halted progress. | Oh My PM resolves the blocker. |
+| completed | Dev-Harness | Every DAG task is completed and verification evidence exists. | Release or archive. |
+
+## Transition rules
+
+- `discovery` can move to `designed` only after every required artifact path is known.
+- `designed` can move to `approved` only after explicit user approval.
+- `approved` can move to `in_development` when Dev-Harness begins execution.
+- Any active state can move to `blocked` if an open blocker prevents honest execution.
+- `blocked` can move back to `designed`, `approved`, or `in_development` depending on the resolved scope.
+- `completed` requires every DAG task status to be `completed`.
+
+## Blocker discipline
+
+A blocker must include an id, raiser, description, proposed solutions, status, and resolution. Do not delete blockers. Mark them resolved and write the resolution.

package/oh-my-pm.schema.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://unpkg.com/oh-my-pm@latest/oh-my-pm.schema.json",
+  "title": "Oh My PM Plugin Configuration",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["preset", "presets"],
+  "properties": {
+    "$schema": { "type": "string" },
+    "preset": { "type": "string", "minLength": 1 },
+    "presets": {
+      "type": "object",
+      "additionalProperties": { "$ref": "#/$defs/preset" },
+      "minProperties": 1
+    }
+  },
+  "$defs": {
+    "preset": {
+      "type": "object",
+      "additionalProperties": { "$ref": "#/$defs/agentPreset" }
+    },
+    "agentPreset": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["model"],
+      "properties": {
+        "model": { "type": "string", "minLength": 1 },
+        "variant": { "type": "string", "minLength": 1 }
+      }
+    }
+  }
+}