martin-loop 0.1.2 → 0.1.3

package/docs/oss/README.md

@@ -1,93 +1,93 @@
-# Martin OSS Core
-
-Martin Loop is a governed AI coding-loop runtime. The core runtime is real and verified through the Phase 12 certification gate; the repo is now in Phase 13 release-candidate engineering, which means the focus is reproducibility, OSS boundary cleanup, and pilot readiness rather than new feature invention.
-
-## What the OSS core includes today
-
-- `@martin/contracts`: shared loop, policy, grounding, leash, budget, and rollback types
-- `@martin/core`: the runtime controller, persistence layer, grounding scanner, leash engine, patch-truth scoring, and rollback restoration logic
-- `@martin/adapters`: normalized Claude CLI, Codex CLI, and direct-provider or stub adapter surfaces
-- `@martin/cli`: the local operator CLI for `run`, `inspect`, and `resume`
-- `@martin/mcp`: the MCP server surface for `martin_run`, `martin_inspect`, and `martin_status`
-
-## What is still outside the initial OSS promise
-
-- The root workspace now exposes the `martin-loop` public package facade, but registry publication is still a later release step.
-- `@martin/contracts`, `@martin/core`, and `@martin/adapters` are still marked `private` in their package manifests.
-- The hosted control-plane and local dashboard remain in the repo, but they are not yet the finalized public OSS boundary.
-- The benchmark harness remains a workspace-only RC surface under `benchmarks/` and is not part of the publishable CLI boundary yet.
-- Final licensing, public package publishing, and managed-product packaging are still gated behind later Phase 13 to Phase 15 work.
-
-That means this repo is ready for grounded engineering review and RC validation, but it is not yet claiming a finished public OSS release.
-
-## Runtime truth the current core enforces
-
-- Explicit policy phases: `GATHER`, `ADMIT`, `PATCH`, `VERIFY`, `RECOVER`, `ESCALATE`, `ABORT`, `HANDOFF`
-- Grounding scans against repo anatomy before success is accepted
-- Blocking leash behavior for unsafe verifier commands, file-scope violations, approval-boundary changes, and secret handling
-- Provenance-aware accounting using `actual`, `estimated`, and `unavailable`
-- Persisted attempt artifacts under `~/.martin/runs/<runId>/artifacts/attempt-XXX/`
-- Patch-truth scoring plus rollback boundary and restore outcome artifacts for discarded or blocked repo-backed attempts
-
-## Trust profiles
-
-Martin currently exposes these execution profiles:
-
-- `strict_local`: safest default for local repo work
-- `ci_safe`: tighter CI-oriented behavior
-- `staging_controlled`: controlled outbound or network allowances with approvals
-- `research_untrusted`: looser network posture for research-oriented runs while still enforcing approval boundaries
-
-## Accounting labels
-
-Martin keeps cost provenance explicit:
-
-- `actual`: reported directly by the provider or adapter settlement
-- `estimated`: derived from pricing logic or modeled usage
-- `unavailable`: the adapter could not produce a trustworthy number
-
-Do not collapse those labels when building dashboards, docs, or public claims.
-
-## Frozen public launch target
-
-The current engineering memo freezes these public-launch targets for release planning:
-
-- install target: `npm install martin-loop`
-- CLI target: `npx martin-loop ...`
-- SDK target: `import { MartinLoop } from "martin-loop"`
-
-Those targets are now implemented in the root package facade and verified through a clean-install smoke test. During the current RC phase, the honest operator path still includes the repo-local workflow documented below and in the quickstart, because public registry publication and broader release packaging remain later steps.
-
-## Reproducibility
-
-From the repo root:
-
-```bash
-pnpm install
-pnpm build
-pnpm rc:validate
-```
-
-`pnpm rc:validate` runs the current RC matrix in an isolated temp home so fresh-home behavior is checked instead of depending on warmed `~/.martin` state. Use `pnpm rc:validate:install` when you also want the RC run to perform a clean `pnpm install --frozen-lockfile` first.
-
-## RC gate commands
-
-The current release-candidate gate is:
-
-- `pnpm oss:validate`
-- `pnpm public:smoke`
-- `pnpm repo:smoke`
-- `pnpm rc:validate`
-- `pnpm pilot:prep:validate`
-- `pnpm release:matrix:local`
-
-`pnpm rc:validate` now includes the machine-checked release-surface audit in addition to the existing build, test, benchmark, provider-path, OSS-boundary, and control-plane checks.
-
-## Where to go next
-
-- [`docs/oss/QUICKSTART.md`](./QUICKSTART.md) for clone-to-first-run setup
-- [`docs/oss/EXAMPLES.md`](./EXAMPLES.md) for grounded CLI and MCP examples
-- [`docs/oss/OSS-BOUNDARY-REPORT.md`](./OSS-BOUNDARY-REPORT.md) for the current machine-checked OSS boundary and public-surface status
-- [`docs/oss/RELEASE-SURFACE-REPORT.md`](./RELEASE-SURFACE-REPORT.md) for the current machine-checked release-surface audit
-- [`docs/pilot/README.md`](../pilot/README.md) for the pilot-prep package that remains explicitly gated behind Phase 13 completion
-- [`../../README.md`](../../README.md) for the repo-level RC status and workspace map
+# Martin OSS Core
+
+Martin Loop is a governed AI coding-loop runtime. The core runtime is real and verified through the Phase 12 certification gate; the repo is now in Phase 13 release-candidate engineering, which means the focus is reproducibility, OSS boundary cleanup, and pilot readiness rather than new feature invention.
+
+## What the OSS core includes today
+
+- `@martin/contracts`: shared loop, policy, grounding, leash, budget, and rollback types
+- `@martin/core`: the runtime controller, persistence layer, grounding scanner, leash engine, patch-truth scoring, and rollback restoration logic
+- `@martin/adapters`: normalized Claude CLI, Codex CLI, and direct-provider or stub adapter surfaces
+- `@martin/cli`: the local operator CLI for `run`, `inspect`, and `resume`
+- `@martin/mcp`: the MCP server surface for `martin_run`, `martin_inspect`, and `martin_status`
+
+## What is still outside the initial OSS promise
+
+- The root workspace now exposes the `martin-loop` public package facade, but registry publication is still a later release step.
+- `@martin/contracts`, `@martin/core`, and `@martin/adapters` are still marked `private` in their package manifests.
+- The hosted control-plane and local dashboard remain in the repo, but they are not yet the finalized public OSS boundary.
+- The benchmark harness remains a workspace-only RC surface under `benchmarks/` and is not part of the publishable CLI boundary yet.
+- Final licensing, public package publishing, and managed-product packaging are still gated behind later Phase 13 to Phase 15 work.
+
+That means this repo is ready for grounded engineering review and RC validation, but it is not yet claiming a finished public OSS release.
+
+## Runtime truth the current core enforces
+
+- Explicit policy phases: `GATHER`, `ADMIT`, `PATCH`, `VERIFY`, `RECOVER`, `ESCALATE`, `ABORT`, `HANDOFF`
+- Grounding scans against repo anatomy before success is accepted
+- Blocking leash behavior for unsafe verifier commands, file-scope violations, approval-boundary changes, and secret handling
+- Provenance-aware accounting using `actual`, `estimated`, and `unavailable`
+- Persisted attempt artifacts under `~/.martin/runs/<runId>/artifacts/attempt-XXX/`
+- Patch-truth scoring plus rollback boundary and restore outcome artifacts for discarded or blocked repo-backed attempts
+
+## Trust profiles
+
+Martin currently exposes these execution profiles:
+
+- `strict_local`: safest default for local repo work
+- `ci_safe`: tighter CI-oriented behavior
+- `staging_controlled`: controlled outbound or network allowances with approvals
+- `research_untrusted`: looser network posture for research-oriented runs while still enforcing approval boundaries
+
+## Accounting labels
+
+Martin keeps cost provenance explicit:
+
+- `actual`: reported directly by the provider or adapter settlement
+- `estimated`: derived from pricing logic or modeled usage
+- `unavailable`: the adapter could not produce a trustworthy number
+
+Do not collapse those labels when building dashboards, docs, or public claims.
+
+## Frozen public launch target
+
+The current engineering memo freezes these public-launch targets for release planning:
+
+- install target: `npm install martin-loop`
+- CLI target: `npx martin-loop ...`
+- SDK target: `import { MartinLoop } from "martin-loop"`
+
+Those targets are now implemented in the root package facade and verified through a clean-install smoke test. During the current RC phase, the honest operator path still includes the repo-local workflow documented below and in the quickstart, because public registry publication and broader release packaging remain later steps.
+
+## Reproducibility
+
+From the repo root:
+
+```bash
+pnpm install
+pnpm build
+pnpm rc:validate
+```
+
+`pnpm rc:validate` runs the current RC matrix in an isolated temp home so fresh-home behavior is checked instead of depending on warmed `~/.martin` state. Use `pnpm rc:validate:install` when you also want the RC run to perform a clean `pnpm install --frozen-lockfile` first.
+
+## RC gate commands
+
+The current release-candidate gate is:
+
+- `pnpm oss:validate`
+- `pnpm public:smoke`
+- `pnpm repo:smoke`
+- `pnpm rc:validate`
+- `pnpm pilot:prep:validate`
+- `pnpm release:matrix:local`
+
+`pnpm rc:validate` now includes the machine-checked release-surface audit in addition to the existing build, test, benchmark, provider-path, OSS-boundary, and control-plane checks.
+
+## Where to go next
+
+- [`docs/oss/QUICKSTART.md`](./QUICKSTART.md) for clone-to-first-run setup
+- [`docs/oss/EXAMPLES.md`](./EXAMPLES.md) for grounded CLI and MCP examples
+- [`docs/oss/OSS-BOUNDARY-REPORT.md`](./OSS-BOUNDARY-REPORT.md) for the current machine-checked OSS boundary and public-surface status
+- [`docs/oss/RELEASE-SURFACE-REPORT.md`](./RELEASE-SURFACE-REPORT.md) for the current machine-checked release-surface audit
+- [`docs/pilot/README.md`](../pilot/README.md) for the pilot-prep package that remains explicitly gated behind Phase 13 completion
+- [`../../README.md`](../../README.md) for the repo-level RC status and workspace map

package/docs/oss/RELEASE-SURFACE-REPORT.json

@@ -1,45 +1,45 @@
-{
-  "generatedAt": "2026-04-21T09:43:03.931Z",
-  "publicSurface": {
-    "packageName": "martin-loop",
-    "installCommand": "npm install martin-loop",
-    "npxCommand": "npx martin-loop",
-    "sdkImportStatement": "import { MartinLoop } from \"martin-loop\""
-  },
-  "rcGateCommands": [
-    "pnpm oss:validate",
-    "pnpm public:smoke",
-    "pnpm repo:smoke",
-    "pnpm rc:validate",
-    "pnpm pilot:prep:validate",
-    "pnpm release:matrix:local"
-  ],
-  "docCoverage": {
-    "readme": {
-      "path": "README.md",
-      "hasPublicSurface": true,
-      "hasRcGateCommands": true,
-      "hasRegistryCaution": true
-    },
-    "ossReadme": {
-      "path": "docs\\oss\\README.md",
-      "hasPublicSurface": true,
-      "hasAccountingLabels": true,
-      "hasTrustProfiles": true,
-      "hasRegistryCaution": true
-    },
-    "quickstart": {
-      "path": "docs\\oss\\QUICKSTART.md",
-      "hasPublicSurface": true,
-      "hasRcGateCommands": true,
-      "hasRegistryCaution": true
-    },
-    "examples": {
-      "path": "docs\\oss\\EXAMPLES.md",
-      "hasRegistryCaution": true
-    }
-  },
-  "deprecatedFiles": [],
-  "verdict": "go",
-  "failures": []
-}
+{
+  "generatedAt": "2026-04-23T14:55:08.167Z",
+  "publicSurface": {
+    "packageName": "martin-loop",
+    "installCommand": "npm install martin-loop",
+    "npxCommand": "npx martin-loop",
+    "sdkImportStatement": "import { MartinLoop } from \"martin-loop\""
+  },
+  "rcGateCommands": [
+    "pnpm oss:validate",
+    "pnpm public:smoke",
+    "pnpm repo:smoke",
+    "pnpm rc:validate",
+    "pnpm pilot:prep:validate",
+    "pnpm release:matrix:local"
+  ],
+  "docCoverage": {
+    "readme": {
+      "path": "README.md",
+      "hasPublicSurface": true,
+      "hasRcGateCommands": true,
+      "hasRegistryCaution": true
+    },
+    "ossReadme": {
+      "path": "docs\\oss\\README.md",
+      "hasPublicSurface": true,
+      "hasAccountingLabels": true,
+      "hasTrustProfiles": true,
+      "hasRegistryCaution": true
+    },
+    "quickstart": {
+      "path": "docs\\oss\\QUICKSTART.md",
+      "hasPublicSurface": true,
+      "hasRcGateCommands": true,
+      "hasRegistryCaution": true
+    },
+    "examples": {
+      "path": "docs\\oss\\EXAMPLES.md",
+      "hasRegistryCaution": true
+    }
+  },
+  "deprecatedFiles": [],
+  "verdict": "go",
+  "failures": []
+}

package/docs/oss/RELEASE-SURFACE-REPORT.md

@@ -1,35 +1,35 @@
-# Martin Loop Phase 13 Release Surface Audit
-
-Generated: 2026-04-21T09:43:03.931Z
-
-## Verdict
-**GO**
-
-## Public Package Surface
-- Package target: martin-loop
-- Install target: `npm install martin-loop`
-- CLI target: `npx martin-loop`
-- SDK target: `import { MartinLoop } from "martin-loop"`
-
-## RC Gate Commands
-- `pnpm oss:validate`
-- `pnpm public:smoke`
-- `pnpm repo:smoke`
-- `pnpm rc:validate`
-- `pnpm pilot:prep:validate`
-- `pnpm release:matrix:local`
-
-## Doc Coverage
-| Surface | Path | Checks |
-|---|---|---|
-| Root README | README.md | public surface: yes, RC gate: yes, registry caution: yes |
-| OSS README | docs/oss/README.md | public surface: yes, accounting labels: yes, trust profiles: yes, registry caution: yes |
-| Quickstart | docs/oss/QUICKSTART.md | public surface: yes, RC gate: yes, registry caution: yes |
-| Examples | docs/oss/EXAMPLES.md | registry caution: yes |
-
-## Deprecated Files
-- None.
-
-## Findings
-- No release-surface drift detected across the audited RC docs and commands.
-
+# Martin Loop Phase 13 Release Surface Audit
+
+Generated: 2026-04-23T14:55:08.167Z
+
+## Verdict
+**GO**
+
+## Public Package Surface
+- Package target: martin-loop
+- Install target: `npm install martin-loop`
+- CLI target: `npx martin-loop`
+- SDK target: `import { MartinLoop } from "martin-loop"`
+
+## RC Gate Commands
+- `pnpm oss:validate`
+- `pnpm public:smoke`
+- `pnpm repo:smoke`
+- `pnpm rc:validate`
+- `pnpm pilot:prep:validate`
+- `pnpm release:matrix:local`
+
+## Doc Coverage
+| Surface | Path | Checks |
+|---|---|---|
+| Root README | README.md | public surface: yes, RC gate: yes, registry caution: yes |
+| OSS README | docs/oss/README.md | public surface: yes, accounting labels: yes, trust profiles: yes, registry caution: yes |
+| Quickstart | docs/oss/QUICKSTART.md | public surface: yes, RC gate: yes, registry caution: yes |
+| Examples | docs/oss/EXAMPLES.md | registry caution: yes |
+
+## Deprecated Files
+- None.
+
+## Findings
+- No release-surface drift detected across the audited RC docs and commands.
+

package/package.json

@@ -1,54 +1,56 @@
-{
-  "name": "martin-loop",
-  "private": false,
-  "version": "0.1.2",
-  "type": "module",
-  "description": "Martin Loop dual-track monorepo for the OSS runtime and hosted SaaS control plane.",
-  "packageManager": "pnpm@10.17.1",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "bin": {
-    "martin-loop": "./dist/bin/martin-loop.js",
-    "martin": "./dist/bin/martin-loop.js"
-  },
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
-    },
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "docs/oss"
-  ],
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "build": "pnpm -r build && node ./scripts/build-public-facade.mjs",
-    "test": "pnpm -r test",
-    "lint": "pnpm -r lint",
-    "oss:validate": "node ./scripts/oss-boundary.mjs",
-    "release:surface:validate": "node ./scripts/release-surface-audit.mjs",
-    "pilot:prep:validate": "node ./scripts/pilot-prep-audit.mjs",
-    "public:smoke": "node ./scripts/public-facade-smoke.mjs",
-    "repo:smoke": "node ./scripts/repo-backed-smoke.mjs",
-    "rc:validate": "node ./scripts/rc-validation.mjs",
-    "rc:validate:install": "node ./scripts/rc-validation.mjs --install",
-    "release:matrix:local": "node ./scripts/release-matrix.mjs",
-    "dev:control-plane": "pnpm --filter @martin/control-plane dev",
-    "run:cli": "pnpm --filter @martin/cli dev",
-    "eval": "pnpm --filter @martin/benchmarks eval",
-    "dev:dashboard": "node apps/local-dashboard/server.js"
-  },
-  "devDependencies": {
-    "@types/node": "^22.13.10",
-    "@types/react": "^19.0.12",
-    "@types/react-dom": "^19.0.5",
-    "tsx": "^4.19.3",
-    "typescript": "^5.8.2",
-    "vitest": "^3.0.8"
-  }
-}
+{
+  "name": "martin-loop",
+  "private": false,
+  "version": "0.1.3",
+  "type": "module",
+  "description": "Martin Loop dual-track monorepo for the OSS runtime and hosted SaaS control plane.",
+  "license": "MIT",
+  "packageManager": "pnpm@10.17.1",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "martin-loop": "./dist/bin/martin-loop.js",
+    "martin": "./dist/bin/martin-loop.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "docs/oss"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "pnpm -r build && node ./scripts/build-public-facade.mjs",
+    "prepublishOnly": "pnpm build",
+    "test": "pnpm -r test",
+    "lint": "pnpm -r lint",
+    "oss:validate": "node ./scripts/oss-boundary.mjs",
+    "release:surface:validate": "node ./scripts/release-surface-audit.mjs",
+    "pilot:prep:validate": "node ./scripts/pilot-prep-audit.mjs",
+    "public:smoke": "node ./scripts/public-facade-smoke.mjs",
+    "repo:smoke": "node ./scripts/repo-backed-smoke.mjs",
+    "rc:validate": "node ./scripts/rc-validation.mjs",
+    "rc:validate:install": "node ./scripts/rc-validation.mjs --install",
+    "release:matrix:local": "node ./scripts/release-matrix.mjs",
+    "dev:control-plane": "pnpm --filter @martin/control-plane dev",
+    "run:cli": "pnpm --filter @martin/cli dev",
+    "eval": "pnpm --filter @martin/benchmarks eval",
+    "dev:dashboard": "node apps/local-dashboard/server.js"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.10",
+    "@types/react": "^19.0.12",
+    "@types/react-dom": "^19.0.5",
+    "tsx": "^4.19.3",
+    "typescript": "^5.8.2",
+    "vitest": "^3.0.8"
+  }
+}