@inneranimalmedia/agentsam-sdk 2.6.9 → 2.6.11

package/docs/plans/LOCAL-STUDIO-GRADUATION-2026-09-26.md

@@ -76,8 +76,8 @@ Ship **Phases 1–5 in full** (Phase 5 is a real IDE product cut, not stubs). Au
 
 **Required code/doc changes:**
 
-1. **IAM** ([`agentsam-account-credentials.js`](/Users/samprimeaux/inneranimalmedia/backend/auth/agentsam-account-credentials.js)): `resolveNativeCliClientId` / `DEFAULT_NATIVE_CLI_CLIENT_ID` must resolve to **`iam_agentsam_sdk_web`** (or accept tokens whose `oauth_clients.client_id` is that production client). Stop requiring `iam_cli_agentsam` for `oauth_cli` / SDK API auth.
-2. **SDK** [`src/lib/auth.js`](/Users/samprimeaux/agentsam-sdk/src/lib/auth.js): `agentsam login` must use `iam_agentsam_sdk_web` (env from vault / documented default aligned with Local Studio Worker — not inventing `iam_cli_agentsam`). Loopback redirects allowed on that client (or Worker-mediated exchange keeping secret on Worker).
+1. **IAM** ([`agentsam-account-credentials.js`](repo://inneranimalmedia/backend/auth/agentsam-account-credentials.js)): `resolveNativeCliClientId` / `DEFAULT_NATIVE_CLI_CLIENT_ID` must resolve to **`iam_agentsam_sdk_web`** (or accept tokens whose `oauth_clients.client_id` is that production client). Stop requiring `iam_cli_agentsam` for `oauth_cli` / SDK API auth.
+2. **SDK** [`src/lib/auth.js`](repo://agentsam-sdk/src/lib/auth.js): `agentsam login` must use `iam_agentsam_sdk_web` (env from vault / documented default aligned with Local Studio Worker — not inventing `iam_cli_agentsam`). Loopback redirects allowed on that client (or Worker-mediated exchange keeping secret on Worker).
 3. **Docs/contracts** that say “native CLI = `iam_cli_agentsam`” (`sdk-auth-contract-consumer.md`, CATALOG, etc.) rewritten to **`iam_agentsam_sdk_web` = Studio + CLI login**.
 4. Deprecate / do-not-teach `AGENTSAM_NATIVE_OAUTH_CLIENT_ID=iam_cli_agentsam` for new installs.
 
@@ -117,7 +117,7 @@ flowchart TB
 
 ## Phase 1 — Windows agentsamd install (parity with LaunchAgent)
 
-**Today:** [`agentsam-sdk/src/commands/runtime.js`](/Users/samprimeaux/agentsam-sdk/src/commands/runtime.js) builds `agentsamd.exe` on win32 but `writeLaunchAgent` returns `null` on non-Darwin; install never registers persistence.
+**Today:** [`agentsam-sdk/src/commands/runtime.js`](repo://agentsam-sdk/src/commands/runtime.js) builds `agentsamd.exe` on win32 but `writeLaunchAgent` returns `null` on non-Darwin; install never registers persistence.
 
 **Implement:**
 - `writeWindowsScheduledTask(home, binary)` — write XML task under `%USERPROFILE%\.agentsam\runtime\` and register via `schtasks /Create /TN "InnerAnimalMedia\\agentsamd" /XML ... /F` (user-level, InteractiveToken, Run at logon + restart on failure).
@@ -133,7 +133,7 @@ flowchart TB
 
 ## Phase 2 — AgentSam family brand / icon grammar
 
-**Today:** [`manifests/local-studio.json`](/Users/samprimeaux/agentsam-sdk/packages/agentsam-desktop-shell/manifests/local-studio.json) + [`icons/local-studio/AgentSam-Mark.svg`](/Users/samprimeaux/agentsam-sdk/packages/agentsam-desktop-shell/icons/local-studio/) + [`scripts/build-brand.mjs`](/Users/samprimeaux/agentsam-sdk/packages/agentsam-desktop-shell/scripts/build-brand.mjs). No 1024 `icon.png` yet.
+**Today:** [`manifests/local-studio.json`](repo://agentsam-sdk/packages/agentsam-desktop-shell/manifests/local-studio.json) + [`icons/local-studio/AgentSam-Mark.svg`](repo://agentsam-sdk/packages/agentsam-desktop-shell/icons/local-studio/) + [`scripts/build-brand.mjs`](repo://agentsam-sdk/packages/agentsam-desktop-shell/scripts/build-brand.mjs). No 1024 `icon.png` yet.
 
 **Implement:**
 - `docs/brand/AGENT_SAM_ICON_GRAMMAR.md` — graphite base, spectral blue→violet accent, one dominant shape, no text in icons; product variations (Local Studio = master + portal; CAD = plane/cube; Ecommerce = modular card).
@@ -167,7 +167,7 @@ flowchart TB
 
 ## Phase 4 — Offline-first shell + agentsamd sidecar
 
-**Stop** sole boot via remote URL in [`tauri.conf.json`](/Users/samprimeaux/agentsam-sdk/packages/agentsam-desktop-shell/src-tauri/tauri.conf.json).
+**Stop** sole boot via remote URL in [`tauri.conf.json`](repo://agentsam-sdk/packages/agentsam-desktop-shell/src-tauri/tauri.conf.json).
 
 **Implement:**
 - `package.json` pre-tauri step: build `apps/local-studio` frontend → copy into `packages/agentsam-desktop-shell/dist/` (replace placeholder).
@@ -186,9 +186,9 @@ flowchart TB
 
 | Piece | Status |
 |---|---|
-| Monaco | Already used via `@monaco-editor/react` in [`monaco-pane.tsx`](/Users/samprimeaux/agentsam-sdk/apps/local-studio/frontend/src/components/workbench/monaco-pane.tsx) — syntax/theme only, **no LSP** |
-| File tree | [`files.tsx`](/Users/samprimeaux/agentsam-sdk/apps/local-studio/frontend/src/components/workbench/files.tsx) has dir toggle/`openDirs` over **virtual scratch artifacts**, not host FS |
-| xterm | Real `@xterm/xterm` in [`terminal.tsx`](/Users/samprimeaux/agentsam-sdk/apps/local-studio/frontend/src/components/workbench/terminal.tsx) + [`terminal-runtime.ts`](/Users/samprimeaux/agentsam-sdk/apps/local-studio/frontend/src/lib/work/terminal-runtime.ts) — primarily **browser virtual shell**; filesystem/PTY path partial |
+| Monaco | Already used via `@monaco-editor/react` in [`monaco-pane.tsx`](repo://agentsam-sdk/apps/local-studio/frontend/src/components/workbench/monaco-pane.tsx) — syntax/theme only, **no LSP** |
+| File tree | [`files.tsx`](repo://agentsam-sdk/apps/local-studio/frontend/src/components/workbench/files.tsx) has dir toggle/`openDirs` over **virtual scratch artifacts**, not host FS |
+| xterm | Real `@xterm/xterm` in [`terminal.tsx`](repo://agentsam-sdk/apps/local-studio/frontend/src/components/workbench/terminal.tsx) + [`terminal-runtime.ts`](repo://agentsam-sdk/apps/local-studio/frontend/src/lib/work/terminal-runtime.ts) — primarily **browser virtual shell**; filesystem/PTY path partial |
 | README claim | “Files open in Monaco / CLI is real xterm” — UI exists; **machine truth + LSP + guided setup** do not |
 
 ### 5A — npm package layout (rapidly deployable SDK)
@@ -204,7 +204,7 @@ Extract / harden under `packages/` (publishable, versioned; Local Studio imports
 | `@inneranimalmedia/agentsam-ide-onboarding` | First-login CLI tutorial scripts (step machine, not a wall of text) |
 | `@inneranimalmedia/agentsam-ide` | Meta package re-exporting the above for one-line Studio install |
 
-Each package: `package.json` exports, typed public API, vitest/node tests, README with “drop into any AgentSam surface.” Prefer evolving [`agentsam-workbench`](/Users/samprimeaux/agentsam-sdk/packages/agentsam-workbench) into these exports rather than a third parallel UI stack.
+Each package: `package.json` exports, typed public API, vitest/node tests, README with “drop into any AgentSam surface.” Prefer evolving [`agentsam-workbench`](repo://agentsam-sdk/packages/agentsam-workbench) into these exports rather than a third parallel UI stack.
 
 ### 5B — Real Files (Monaco + collapsible tree)
 

package/docs/plans/MACHINE-FIRST-APPS-TUI-2026-09-24.md

@@ -22,7 +22,7 @@ isProject: false
 
 # Machine-first AgentSam + Apps Clack Catalog
 
-**Home:** [`/Users/samprimeaux/agentsam-sdk`](/Users/samprimeaux/agentsam-sdk) · supersedes pending todos in [UNIVERSAL-INGEST-MACHINE-FIRST-2026-09-24.md](./UNIVERSAL-INGEST-MACHINE-FIRST-2026-09-24.md)
+**Home:** [`repo://agentsam-sdk`](repo://agentsam-sdk) · supersedes pending todos in [UNIVERSAL-INGEST-MACHINE-FIRST-2026-09-24.md](./UNIVERSAL-INGEST-MACHINE-FIRST-2026-09-24.md)
 
 **Locked product intent:** Apps become a Clack/TUI selectable catalog of packaged previews/prebuilds of past work. Selecting an app leads to Preview (primary), then Scaffold/Add, then Deploy when maturity allows. Machine Intelligence + world-state make that catalog honest (calculated maturity, not hand badges).
 
@@ -67,12 +67,12 @@ flowchart TB
 
 | Piece | Path | Use |
 |-------|------|-----|
-| CLI router (`app`/`apps` alias) | [`src/cli.js`](/Users/samprimeaux/agentsam-sdk/src/cli.js) | Route bare `apps` → TUI |
-| App commands today | [`src/commands/app.js`](/Users/samprimeaux/agentsam-sdk/src/commands/app.js) | Extend discovery + actions; today only `agentsam.app.json` (4 product apps) |
+| CLI router (`app`/`apps` alias) | [`src/cli.js`](repo://agentsam-sdk/src/cli.js) | Route bare `apps` → TUI |
+| App commands today | [`src/commands/app.js`](repo://agentsam-sdk/src/commands/app.js) | Extend discovery + actions; today only `agentsam.app.json` (4 product apps) |
 | Clack already | `@clack/prompts` in help/models/providers/scaffold | Same patterns for apps menu |
-| Inspect | [`src/commands/product.js`](/Users/samprimeaux/agentsam-sdk/src/commands/product.js) → [`repository-snapshot.js`](/Users/samprimeaux/agentsam-sdk/src/capabilities/repository-snapshot.js) | Expand into world-state envelope |
-| Progression / next | [`src/progression/engine.js`](/Users/samprimeaux/agentsam-sdk/src/progression/engine.js) | Feed maturity next-actions |
-| Brand Intelligence | [`docs/BRAND_INTELLIGENCE.md`](/Users/samprimeaux/agentsam-sdk/docs/BRAND_INTELLIGENCE.md) + `packages/agentsam-brand` | Consumer of world-state + primitives |
+| Inspect | [`src/commands/product.js`](repo://agentsam-sdk/src/commands/product.js) → [`repository-snapshot.js`](repo://agentsam-sdk/src/capabilities/repository-snapshot.js) | Expand into world-state envelope |
+| Progression / next | [`src/progression/engine.js`](repo://agentsam-sdk/src/progression/engine.js) | Feed maturity next-actions |
+| Brand Intelligence | [`docs/BRAND_INTELLIGENCE.md`](repo://agentsam-sdk/docs/BRAND_INTELLIGENCE.md) + `packages/agentsam-brand` | Consumer of world-state + primitives |
 | Verify | `scripts/verify-package.mjs`, `verify-source-boundaries.mjs` | Strengthen; wire into maturity |
 | Theme apps | `.agentsam/app.json` on 7 harvested sites | Include in catalog (today invisible to `listAppManifests`) |
 
@@ -81,7 +81,7 @@ flowchart TB
 ## Batch A — Machine Intelligence foundation
 
 ### A1. Docs
-- Add [`docs/MACHINE_INTELLIGENCE.md`](/Users/samprimeaux/agentsam-sdk/docs/MACHINE_INTELLIGENCE.md): ladder, MINI/APP/WORLD, confidence ≠ risk, receipts, LLM as one handler.
+- Add [`docs/MACHINE_INTELLIGENCE.md`](repo://agentsam-sdk/docs/MACHINE_INTELLIGENCE.md): ladder, MINI/APP/WORLD, confidence ≠ risk, receipts, LLM as one handler.
 - Cross-link Brand Intelligence + Repository Intelligence + this Apps catalog.
 - Demote mini as architectural poster in help copy (Batch D completes that).
 
@@ -111,7 +111,7 @@ Converge into one JSON envelope (new capability `world.state` or extend `reposit
 `agentsam inspect [path]` returns this envelope for arbitrary paths **and** every `apps/*`.
 
 ### B2. Discovery + maturity engine
-Extend [`listAppManifests`](/Users/samprimeaux/agentsam-sdk/src/commands/app.js):
+Extend [`listAppManifests`](repo://agentsam-sdk/src/commands/app.js):
 
 1. Prefer `agentsam.app.json` (product apps).
 2. Fall back to `.agentsam/app.json` (theme-refinery / harvested).
@@ -179,8 +179,8 @@ Non-TTY / scripted: keep `agentsam app list|info|doctor|preview|scaffold` and ad
 
 Implementation touchpoints:
 
-- Expand [`src/commands/app.js`](/Users/samprimeaux/agentsam-sdk/src/commands/app.js) with `runAppsInteractive()` using `@clack/prompts` `select` / `confirm` (same style as [`src/ui/cli/help.js`](/Users/samprimeaux/agentsam-sdk/src/ui/cli/help.js)).
-- [`src/cli.js`](/Users/samprimeaux/agentsam-sdk/src/cli.js): bare `apps` with empty argv → interactive; `app list` stays non-interactive default for scripts.
+- Expand [`src/commands/app.js`](repo://agentsam-sdk/src/commands/app.js) with `runAppsInteractive()` using `@clack/prompts` `select` / `confirm` (same style as [`src/ui/cli/help.js`](repo://agentsam-sdk/src/ui/cli/help.js)).
+- [`src/cli.js`](repo://agentsam-sdk/src/cli.js): bare `apps` with empty argv → interactive; `app list` stays non-interactive default for scripts.
 
 ### D2. npm distribute
 - Curate publishable set for product apps (cad / cms / studio / ecommerce) toward `@inneranimalmedia/<app>` or documented `agentsam app add` from registry.
@@ -224,4 +224,4 @@ Suggested first PR slice after plan approval: A1+A2 + B2 discovery expansion + D
 
 ## Optional hygiene (non-blocking)
 
-Review leftover `/Users/samprimeaux/agent-worktrees/*` clones (stale SDK @ 892 behind, etc.) when convenient.
+Review leftover `worktree://*` clones (stale SDK @ 892 behind, etc.) when convenient.

package/docs/plans/RECONCILIATION-2026-09-19.md

@@ -4,7 +4,7 @@
 `ASTRA-BRIEF-2026-09-18.md`) are backlog/reference only. Do not treat them as
 a live status report.
 
-Repo: `/Users/samprimeaux/agentsam-sdk`
+Repo: `repo://agentsam-sdk`
 
 ## Repository truth (verified this pass)
 
@@ -24,11 +24,11 @@ No `npm publish`. No Worker deployment for that batch.
 
 | Path | Branch | Tip |
 | --- | --- | --- |
-| `/Users/samprimeaux/agentsam-sdk` | `main` | `88cb30d` |
-| `/Users/samprimeaux/agent-worktrees/studio-auth-ai-wiring` | `feat/studio-auth-and-ai-wiring` | `b8fffbb` |
-| `/Users/samprimeaux/agentsam-sdk-errors` | `feat/errors-v1-runtime-contract` | `f39b92b` (local; remote ahead elsewhere) |
-| `/Users/samprimeaux/agentsam-sdk-errors-integrate` | `integrate/errors-v1-main` | `0136a96` |
-| `/Users/samprimeaux/agentsam-sdk-tui-oauth` | `feat/cli-oauth-tui-productization` | `3a86138` (remote gone; tip is ancestor of main) |
+| `repo://agentsam-sdk` | `main` | `88cb30d` |
+| `worktree://studio-auth-ai-wiring` | `feat/studio-auth-and-ai-wiring` | `b8fffbb` |
+| `repo://agentsam-sdk-errors` | `feat/errors-v1-runtime-contract` | `f39b92b` (local; remote ahead elsewhere) |
+| `repo://agentsam-sdk-errors-integrate` | `integrate/errors-v1-main` | `0136a96` |
+| `repo://agentsam-sdk-tui-oauth` | `feat/cli-oauth-tui-productization` | `3a86138` (remote gone; tip is ancestor of main) |
 
 ### Parallel remote branches to inspect before rebuilding equivalent work