@adammcarter/use-cases 0.1.0

package/packages/core/dist/hosts/types.d.ts

@@ -0,0 +1,122 @@
+import type { Diagnostic } from "../schema/index.js";
+export type HostName = "claude" | "codex" | "copilot" | "opencode";
+export type HostProjectionMode = "dry-run" | "write" | "revert";
+export type HostSupportStatus = "expected" | "installed" | "projected" | "conformant_static" | "verified_with_evidence" | "partial_with_evidence" | "blocked" | "unsupported" | "not_tested";
+export type HostProfile = {
+    schema_version: 1;
+    profile_id: string;
+    host: HostName;
+    surface: string;
+    profile_version: number;
+    host_version: {
+        min: string | null;
+        tested: string | null;
+        notes: string | null;
+    };
+    os_runtime: {
+        supported: string[];
+    };
+    installation_mode: {
+        expected: string;
+    };
+    permission_mode: {
+        expected: string;
+    };
+    expected_capabilities: Record<string, "required" | "optional" | "unsupported">;
+    projection_targets: HostProjectionTarget[];
+    doctor_checks: string[];
+    conformance_checks: string[];
+    known_limitations: string[];
+};
+export type HostProjectionTarget = {
+    kind: "activation_stub" | "skill_stub";
+    path: string;
+    managed: boolean;
+    content_policy: "thin_stub" | "full_copy_required";
+};
+export type HostProfileLoadResult = {
+    schema_version: 1;
+    complete: boolean;
+    profile: HostProfile | null;
+    diagnostics: Diagnostic[];
+};
+export type ProjectionOperationAction = "create" | "update_managed" | "skip_unchanged" | "conflict_user_modified" | "refuse_unsafe_path" | "delete_managed_on_revert";
+export type HostProjectionOperation = {
+    action: ProjectionOperationAction;
+    path: string;
+    reason: string;
+    before_hash: string | null;
+    after_hash: string | null;
+};
+export type HostProjectionResult = {
+    schema_version: 1;
+    host: HostName;
+    surface: string;
+    profile_id: string;
+    mode: HostProjectionMode;
+    complete: boolean;
+    manifest_path: string;
+    source_skill_hashes: Record<string, string>;
+    operations: HostProjectionOperation[];
+    diagnostics: Diagnostic[];
+};
+export type HostSupportSummary = {
+    expected: boolean;
+    installed: boolean;
+    static_conformant: boolean;
+    verified_with_evidence: boolean;
+    evidence_event_ids: string[];
+};
+export type HostProductionSupportSummary = {
+    profile_available: boolean;
+    projected: boolean;
+    static_conformant: boolean;
+    executable_smoke: HostExecutableSmoke["status"];
+    verified_with_evidence: boolean;
+    evidence_event_ids: string[];
+};
+export type HostExecutableSmoke = {
+    status: "passed" | "failed" | "not_run";
+    executable: string;
+    argv: string[];
+    reason_code?: "ok" | "executable_not_found" | "executable_unavailable" | "executable_timeout" | "executable_run_error" | "nonzero_exit";
+    reason: string;
+    exit_code: number | null;
+    stdout?: string;
+    stderr?: string;
+};
+export type HostDoctorResult = {
+    schema_version: 1;
+    host: HostName;
+    surface: string;
+    profile_id: string;
+    support_status: HostSupportStatus;
+    support: HostSupportSummary;
+    checks: Array<{
+        id: string;
+        result: "pass" | "fail" | "not_tested";
+        message: string;
+    }>;
+    diagnostics: Diagnostic[];
+};
+export type HostConformanceResult = {
+    schema_version: 1;
+    host: HostName;
+    surface: string;
+    profile_id: string;
+    checked_at: string;
+    status_basis: "static_conformance_only";
+    support_status: HostSupportStatus;
+    support: HostProductionSupportSummary;
+    profile_hash: string;
+    projection_manifest_hash: string | null;
+    evidence_event_ids: string[];
+    executable_smoke: HostExecutableSmoke;
+    checks: Array<{
+        id: string;
+        result: "pass" | "fail" | "not_tested";
+        message: string;
+    }>;
+    diagnostics: Diagnostic[];
+};
+//# sourceMappingURL=types.d.ts.map

package/packages/core/dist/hosts/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/hosts/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;AACnE,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAChE,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,WAAW,GACX,WAAW,GACX,mBAAmB,GACnB,wBAAwB,GACxB,uBAAuB,GACvB,SAAS,GACT,aAAa,GACb,YAAY,CAAC;AAEjB,MAAM,MAAM,WAAW,GAAG;IACxB,cAAc,EAAE,CAAC,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE;QACZ,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;KACtB,CAAC;IACF,UAAU,EAAE;QACV,SAAS,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IACF,iBAAiB,EAAE;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,eAAe,EAAE;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,aAAa,CAAC,CAAC;IAC/E,kBAAkB,EAAE,oBAAoB,EAAE,CAAC;IAC3C,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,iBAAiB,GAAG,YAAY,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,WAAW,GAAG,oBAAoB,CAAC;CACpD,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,cAAc,EAAE,CAAC,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,yBAAyB,GACjC,QAAQ,GACR,gBAAgB,GAChB,gBAAgB,GAChB,wBAAwB,GACxB,oBAAoB,GACpB,0BAA0B,CAAC;AAE/B,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE,yBAAyB,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,cAAc,EAAE,CAAC,CAAC;IAClB,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,kBAAkB,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,UAAU,EAAE,uBAAuB,EAAE,CAAC;IACtC,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,sBAAsB,EAAE,OAAO,CAAC;IAChC,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gBAAgB,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAChD,sBAAsB,EAAE,OAAO,CAAC;IAChC,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,CAAC,EACR,IAAI,GACJ,sBAAsB,GACtB,wBAAwB,GACxB,oBAAoB,GACpB,sBAAsB,GACtB,cAAc,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,cAAc,EAAE,CAAC,CAAC;IAClB,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,iBAAiB,CAAC;IAClC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,MAAM,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvF,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,cAAc,EAAE,CAAC,CAAC;IAClB,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,yBAAyB,CAAC;IACxC,cAAc,EAAE,iBAAiB,CAAC;IAClC,OAAO,EAAE,4BAA4B,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,gBAAgB,EAAE,mBAAmB,CAAC;IACtC,MAAM,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvF,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B,CAAC"}

package/packages/core/dist/hosts/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/packages/core/dist/hosts/types.js.map

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

package/packages/core/dist/index.d.ts

@@ -0,0 +1,26 @@
+export * from "./version.js";
+export * from "./schema/index.js";
+export * from "./errors.js";
+export * from "./errors/registry.js";
+export * from "./roots.js";
+export * from "./redact.js";
+export * from "./useCases/integrity.js";
+export * from "./useCases/loadUseCaseMatrix.js";
+export * from "./useCases/mutateUseCaseMatrix.js";
+export * from "./useCases/query.js";
+export * from "./useCases/types.js";
+export * from "./useCases/validateUseCaseFile.js";
+export * from "./evidence/index.js";
+export * from "./presentation/index.js";
+export * from "./capsules/index.js";
+export * from "./showcase/index.js";
+export * from "./skills/index.js";
+export * from "./hosts/index.js";
+export * from "./migration/index.js";
+export * from "./package/index.js";
+export * from "./markers/cli/index.js";
+export * from "./markers/keyring.js";
+export * from "./markers/keygen.js";
+export * from "./markers/ciAuthority.js";
+export * from "./init/index.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/core/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mCAAmC,CAAC;AAClD,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AAEnC,cAAc,wBAAwB,CAAC;AAEvC,cAAc,sBAAsB,CAAC;AAErC,cAAc,qBAAqB,CAAC;AAEpC,cAAc,0BAA0B,CAAC;AAEzC,cAAc,iBAAiB,CAAC"}

package/packages/core/dist/index.js

@@ -0,0 +1,31 @@
+export * from "./version.js";
+export * from "./schema/index.js";
+export * from "./errors.js";
+export * from "./errors/registry.js";
+export * from "./roots.js";
+export * from "./redact.js";
+export * from "./useCases/integrity.js";
+export * from "./useCases/loadUseCaseMatrix.js";
+export * from "./useCases/mutateUseCaseMatrix.js";
+export * from "./useCases/query.js";
+export * from "./useCases/types.js";
+export * from "./useCases/validateUseCaseFile.js";
+export * from "./evidence/index.js";
+export * from "./presentation/index.js";
+export * from "./capsules/index.js";
+export * from "./showcase/index.js";
+export * from "./skills/index.js";
+export * from "./hosts/index.js";
+export * from "./migration/index.js";
+export * from "./package/index.js";
+// Phase 7: use-case-marker CLI command cores (bind / scan / prove / validate-ledger).
+export * from "./markers/cli/index.js";
+// Public-v1: opt-in multi-key keyring resolver (rotation / revocation).
+export * from "./markers/keyring.js";
+// Public-v1: opt-in signed-tier ed25519 keypair generation (`uc keygen`).
+export * from "./markers/keygen.js";
+// Public-v1: CI-neutral provenance authority detection (detectCiAuthority).
+export * from "./markers/ciAuthority.js";
+// Public-v1 Phase 5 onboarding: `uc init` workspace scaffolder.
+export * from "./init/index.js";
+//# sourceMappingURL=index.js.map

package/packages/core/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mCAAmC,CAAC;AAClD,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,sFAAsF;AACtF,cAAc,wBAAwB,CAAC;AACvC,wEAAwE;AACxE,cAAc,sBAAsB,CAAC;AACrC,0EAA0E;AAC1E,cAAc,qBAAqB,CAAC;AACpC,4EAA4E;AAC5E,cAAc,0BAA0B,CAAC;AACzC,gEAAgE;AAChE,cAAc,iBAAiB,CAAC"}

package/packages/core/dist/init/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./scaffold.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/core/dist/init/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/init/index.ts"],"names":[],"mappings":"AACA,cAAc,eAAe,CAAC"}

package/packages/core/dist/init/index.js

@@ -0,0 +1,3 @@
+// Public-v1 Phase 5 onboarding: `uc init` workspace scaffolder.
+export * from "./scaffold.js";
+//# sourceMappingURL=index.js.map

package/packages/core/dist/init/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/init/index.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,cAAc,eAAe,CAAC"}

package/packages/core/dist/init/scaffold.d.ts

@@ -0,0 +1,28 @@
+import { type Diagnostic } from "../schema/index.js";
+export declare const INIT_TEMPLATES: readonly ["generic", "js-vitest", "python-pytest", "go-test"];
+export type InitTemplate = (typeof INIT_TEMPLATES)[number];
+export declare function isInitTemplate(value: unknown): value is InitTemplate;
+export type ScaffoldWorkspaceOptions = {
+    repoRoot: string;
+    template?: InitTemplate;
+    component?: string;
+    force?: boolean;
+};
+export type ScaffoldWorkspaceResult = {
+    schema_version: 1;
+    status: "created" | "blocked";
+    template: InitTemplate;
+    component_id: string;
+    default_verifier: {
+        id: string;
+        kind: "preset" | "script";
+        preset?: string;
+        command?: string[];
+    };
+    created_files: string[];
+    next_steps: string[];
+    diagnostics: Diagnostic[];
+};
+export declare function scaffoldWorkspace(options: ScaffoldWorkspaceOptions): ScaffoldWorkspaceResult;
+export declare function nextSteps(): string[];
+//# sourceMappingURL=scaffold.d.ts.map

package/packages/core/dist/init/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/init/scaffold.ts"],"names":[],"mappings":"AAeA,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGjE,eAAO,MAAM,cAAc,+DAAgE,CAAC;AAC5F,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE;AAED,MAAM,MAAM,wBAAwB,GAAG;IAErC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,cAAc,EAAE,CAAC,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IAGrB,gBAAgB,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACjG,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B,CAAC;AAiBF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,uBAAuB,CA8E5F;AA2LD,wBAAgB,SAAS,IAAI,MAAM,EAAE,CASpC"}

package/packages/core/dist/init/scaffold.js

@@ -0,0 +1,293 @@
+// `uc init` — scaffold a minimal, WORKING Use Cases workspace.
+//
+// Takes a brand-new repo from nothing to a bindable, verifiable matrix in one
+// command: a workspace config (`use-cases.yml`) wired to a default
+// verifier matching the chosen template, plus a `use-cases/` dir holding one
+// example row that VALIDATES against the use-case-file schema. The scaffolded
+// workspace passes `uc matrix validate` out of the box.
+//
+// SAFETY: never generates or writes any private key, never writes a GitHub
+// workflow file. If a `use-cases.yml` already exists it REFUSES unless
+// `force` is set (a `blocked` result, never a silent clobber). All writes are
+// path-contained inside the repo root.
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { dirname, join, relative, resolve, sep } from "node:path";
+import { diagnostic } from "../schema/index.js";
+import { isValidId, resolveContainedPath } from "../roots.js";
+export const INIT_TEMPLATES = ["generic", "js-vitest", "python-pytest", "go-test"];
+export function isInitTemplate(value) {
+    return typeof value === "string" && INIT_TEMPLATES.includes(value);
+}
+const CONFIG_FILE = "use-cases.yml";
+const USE_CASE_FILE = join("use-cases", "example.yml");
+const DEFAULT_VERIFIER_ID = "acceptance";
+// The example row id scaffolded in `use-cases/example.yml`. The js-vitest
+// runnable example binds its marked source span to this id, and the acceptance
+// test lives at the path the `js.vitest` preset derives from it
+// (`tests/use-cases/<row-id>.test.ts`).
+const EXAMPLE_ROW_ID = "example.feature.happy_path";
+const JS_VITEST_SRC_FILE = join("src", "example.ts");
+const JS_VITEST_TEST_FILE = join("tests", "use-cases", `${EXAMPLE_ROW_ID}.test.ts`);
+export function scaffoldWorkspace(options) {
+    const template = options.template ?? "generic";
+    const repoRoot = resolve(options.repoRoot);
+    const componentId = deriveComponentId(options.component ?? baseNameOf(repoRoot));
+    const verifier = defaultVerifierFor(template);
+    const blocked = (diagnostic) => ({
+        schema_version: 1,
+        status: "blocked",
+        template,
+        component_id: componentId,
+        default_verifier: verifier.summary,
+        created_files: [],
+        next_steps: [],
+        diagnostics: [diagnostic]
+    });
+    // Template-specific runnable-example files (e.g. js-vitest ships a marked
+    // source file + a matching vitest test so `verify` works out of the box).
+    const templateFiles = templateFilesFor(template);
+    // Path-containment: every write target must stay inside the repo root.
+    let configPath;
+    let useCasePath;
+    let templatePaths;
+    try {
+        configPath = resolveContainedPath(repoRoot, CONFIG_FILE, "Scaffold target escapes the repo boundary.");
+        useCasePath = resolveContainedPath(repoRoot, USE_CASE_FILE, "Scaffold target escapes the repo boundary.");
+        templatePaths = templateFiles.map((file) => ({
+            relPath: file.relPath,
+            absPath: resolveContainedPath(repoRoot, file.relPath, "Scaffold target escapes the repo boundary."),
+            body: file.body
+        }));
+    }
+    catch (error) {
+        return blocked(diagnostic("init.path_escape", error instanceof Error ? error.message : "Scaffold target escapes the repo boundary."));
+    }
+    if (existsSync(configPath) && !options.force) {
+        return blocked(diagnostic("init.workspace_exists", `A workspace config already exists at ${CONFIG_FILE}. Re-run with --force to overwrite.`, CONFIG_FILE));
+    }
+    const configBody = renderConfig(componentId, verifier);
+    const useCaseBody = renderExampleUseCase();
+    mkdirSync(dirname(useCasePath), { recursive: true });
+    writeFileSync(configPath, configBody, "utf8");
+    writeFileSync(useCasePath, useCaseBody, "utf8");
+    for (const file of templatePaths) {
+        mkdirSync(dirname(file.absPath), { recursive: true });
+        writeFileSync(file.absPath, file.body, "utf8");
+    }
+    return {
+        schema_version: 1,
+        status: "created",
+        template,
+        component_id: componentId,
+        default_verifier: verifier.summary,
+        created_files: [
+            toPosix(relative(repoRoot, configPath)),
+            toPosix(relative(repoRoot, useCasePath)),
+            ...templatePaths.map((file) => toPosix(relative(repoRoot, file.absPath)))
+        ],
+        next_steps: nextSteps(),
+        diagnostics: []
+    };
+}
+function defaultVerifierFor(template) {
+    const preset = (id) => ({
+        yaml: [`    preset: ${id}`, "    evidence_kind: test_result"],
+        summary: { id: DEFAULT_VERIFIER_ID, kind: "preset", preset: id }
+    });
+    switch (template) {
+        case "js-vitest":
+            return preset("js.vitest");
+        case "python-pytest":
+            return preset("python.pytest");
+        case "go-test":
+            return preset("go.test");
+        case "generic":
+        default: {
+            // command.generic ships no command, so the placeholder lives here as an
+            // explicit script verifier. `false` makes it FAIL until configured, so a
+            // placeholder can never accidentally mint a passing proof. `{slug}` is
+            // substituted with the row id at run time.
+            const command = ["false", "TODO-replace-with-your-verifier-command-for-{slug}"];
+            return {
+                yaml: [
+                    "    # TODO: replace this placeholder with the real command that verifies a row.",
+                    "    # `{slug}` is substituted with the row id at run time. It exits non-zero",
+                    "    # until you configure it, so a placeholder can never mint a passing proof.",
+                    "    kind: script",
+                    "    evidence_kind: test_result",
+                    `    command: [${command.map((part) => JSON.stringify(part)).join(", ")}]`
+                ],
+                summary: { id: DEFAULT_VERIFIER_ID, kind: "script", command }
+            };
+        }
+    }
+}
+function renderConfig(componentId, verifier) {
+    return [
+        "schema_version: 1",
+        `workspace_id: ${componentId}`,
+        `component_id: ${componentId}`,
+        "data_root: .",
+        "use_cases_dir: use-cases",
+        "evidence_dir: evidence",
+        "demo_capsules_dir: demo-capsules",
+        "showcase_runs_dir: showcase-runs",
+        "default_workflow_mode: continuous",
+        "# Verifiers map a row's required_verifiers id to a real command. `default` is",
+        "# used by any row that does not name its own verifier. See docs/cli.md.",
+        "verifiers:",
+        `  default: ${DEFAULT_VERIFIER_ID}`,
+        `  ${DEFAULT_VERIFIER_ID}:`,
+        ...verifier.yaml,
+        ""
+    ].join("\n");
+}
+function renderExampleUseCase() {
+    return [
+        "schema_version: 1",
+        "# TODO: replace this example with a real use case for your project.",
+        "# Each row describes one observable behaviour your product must keep working.",
+        "# Once you bind it to code (`uc bind`) and CI proves it, the row reaches FRESH.",
+        "feature:",
+        "  id: example.feature",
+        "  name: Example feature",
+        "  summary: An example use case scaffolded by `uc init` — replace it with your own.",
+        "metadata:",
+        "  owner: unassigned",
+        "  lifecycle: active",
+        "use_cases:",
+        "  - id: example.feature.happy_path",
+        "    title: Example happy path",
+        "    lifecycle: active",
+        "    value_tier: core",
+        "    journey_role: golden",
+        "    usage_frequency: common",
+        "    tags: [example]",
+        "    source_refs:",
+        "      - kind: file",
+        "        path: src/example.ts",
+        "    actor: user",
+        "    intent: Demonstrate the use-cases row shape so you can replace it.",
+        "    preconditions:",
+        "      - The project is set up.",
+        "    trigger: The user performs the example action.",
+        "    scenarios:",
+        "      - id: example.feature.happy_path.main",
+        "        kind: steps",
+        "        steps:",
+        "          - Perform the example action.",
+        "          - Observe the expected result.",
+        "    observable_outcomes:",
+        "      - The expected result is visible to the user.",
+        "    host_applicability:",
+        "      - host_surface: codex.cli",
+        "        supported: true",
+        "    verification_policy:",
+        "      mode: requirements",
+        "      requirements:",
+        "        - evidence_kind: test_result",
+        `          required_verifiers: [${DEFAULT_VERIFIER_ID}]`,
+        "          minimum_count: 1",
+        "    approval_policy:",
+        "      mode: none",
+        ""
+    ].join("\n");
+}
+// Extra files that make a template's scaffolded example RUNNABLE out of the
+// box. The `generic`, `python-pytest`, and `go-test` templates ship none here
+// (python-pytest's runnable example lives under examples/, not the scaffolder);
+// js-vitest ships a marked source file + a matching vitest test so that
+// `bind --register-existing` + `verify` succeed immediately after `init`.
+function templateFilesFor(template) {
+    switch (template) {
+        case "js-vitest":
+            return [
+                { relPath: JS_VITEST_SRC_FILE, body: renderJsVitestSource() },
+                { relPath: JS_VITEST_TEST_FILE, body: renderJsVitestTest() }
+            ];
+        default:
+            return [];
+    }
+}
+// The implementation the `example.feature.happy_path` row describes, wrapped in
+// a Use Cases marker span (`//` is the configured `.ts` comment prefix).
+// `bind --register-existing` binds the row to exactly these source lines.
+function renderJsVitestSource() {
+    return [
+        "// A tiny, self-contained module an adopter might own. The exported",
+        "// function below is the implementation the use-case row",
+        `// \`${EXAMPLE_ROW_ID}\` describes. It is wrapped in a Use Cases`,
+        "// marker span (the `@use-case` start/end comments) so the matrix can bind",
+        "// the row to exactly these source lines. Replace it with your own code.",
+        "",
+        `//: @use-case: ${EXAMPLE_ROW_ID}`,
+        "export function greet(name: string): string {",
+        '  const trimmed = name.trim();',
+        '  if (trimmed === "") {',
+        '    throw new Error("name must not be empty");',
+        "  }",
+        "  return `Hello, ${trimmed}!`;",
+        "}",
+        `//: @use-case: end ${EXAMPLE_ROW_ID}`,
+        ""
+    ].join("\n");
+}
+// A plain vitest module at the path the `js.vitest` preset derives from the row
+// id (`tests/use-cases/<row-id>.test.ts`), so `uc verify` runs it as-is.
+function renderJsVitestTest() {
+    return [
+        `// Acceptance test for the \`${EXAMPLE_ROW_ID}\` use-case row.`,
+        "//",
+        "// The `js.vitest` verifier preset runs this file with",
+        `//   pnpm -s vitest run tests/use-cases/${EXAMPLE_ROW_ID}.test.ts`,
+        "// (the path the preset derives from the row id). Replace these assertions",
+        "// with real ones as you replace the example row with your own use case.",
+        'import { describe, expect, test } from "vitest";',
+        'import { greet } from "../../src/example.js";',
+        "",
+        `describe("${EXAMPLE_ROW_ID}", () => {`,
+        '  test("greets a named user", () => {',
+        '    expect(greet("Ada")).toBe("Hello, Ada!");',
+        "  });",
+        "",
+        '  test("trims surrounding whitespace", () => {',
+        '    expect(greet("  Ada  ")).toBe("Hello, Ada!");',
+        "  });",
+        "",
+        '  test("rejects an empty name", () => {',
+        '    expect(() => greet("   ")).toThrow();',
+        "  });",
+        "});",
+        ""
+    ].join("\n");
+}
+export function nextSteps() {
+    return [
+        "Edit use-cases/example.yml — replace the example row with a real use case.",
+        "Run `uc matrix validate --repo . --json` to confirm the matrix is clean.",
+        "Bind the implementing code with `uc bind` — code-marker grammar in docs/markers-adoption.md.",
+        "Wire the `acceptance` verifier in use-cases.yml to your real test command (docs/cli.md).",
+        "Generate an ed25519 keypair — commit the PUBLIC key, keep the PRIVATE key in a CI secret only (docs/security.md).",
+        "Let trusted CI mint FRESH proofs with `uc prove` (docs/cli.md, docs/security.md)."
+    ];
+}
+function deriveComponentId(raw) {
+    const segments = raw
+        .toLowerCase()
+        .split(".")
+        .map((segment) => segment
+        .replace(/[^a-z0-9_-]+/g, "-")
+        .replace(/^[-_]+/, "")
+        .replace(/[-_]+$/, ""))
+        .filter((segment) => segment.length > 0 && /^[a-z0-9]/.test(segment));
+    const candidate = segments.join(".");
+    return isValidId(candidate) ? candidate : "workspace";
+}
+function baseNameOf(repoRoot) {
+    const parts = repoRoot.split(sep).filter((part) => part.length > 0);
+    return parts[parts.length - 1] ?? "workspace";
+}
+function toPosix(path) {
+    return path.split(sep).join("/");
+}
+//# sourceMappingURL=scaffold.js.map

package/packages/core/dist/init/scaffold.js.map

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

package/packages/core/dist/markers/appendOnly.d.ts

@@ -0,0 +1,23 @@
+export interface AppendOnlyViolation {
+    kind: "edited" | "deleted";
+    index: number;
+    old_line: string;
+    new_line: string | null;
+    message: string;
+}
+export type AppendOnlyResult = {
+    ok: true;
+} | {
+    ok: false;
+    violation: AppendOnlyViolation;
+};
+export declare function appendOnly(oldLines: ReadonlyArray<string>, newLines: ReadonlyArray<string>): AppendOnlyResult;
+export declare function splitJsonlLines(text: string): string[];
+export type GitRunner = (args: string[], cwd?: string) => string;
+export interface ReadBaseRefOptions {
+    cwd?: string;
+    runner?: GitRunner;
+}
+export declare function readBaseRefFile(baseRef: string, path: string, options?: ReadBaseRefOptions): string;
+export declare function appendOnlyAgainstBaseRef(baseRef: string, path: string, currentText: string, options?: ReadBaseRefOptions): AppendOnlyResult;
+//# sourceMappingURL=appendOnly.d.ts.map

package/packages/core/dist/markers/appendOnly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appendOnly.d.ts","sourceRoot":"","sources":["../../src/markers/appendOnly.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,mBAAmB;IAGlC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,gBAAgB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,SAAS,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAG5F,wBAAgB,UAAU,CACxB,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,EAC/B,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,GAC9B,gBAAgB,CA4BlB;AAID,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAStD;AAGD,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;AAEjE,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAYD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAaR;AAID,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,kBAAuB,GAC/B,gBAAgB,CAGlB"}