receipt-agent-cli 0.1.0

package/package.json

@@ -0,0 +1,104 @@
+{
+  "name": "receipt-agent-cli",
+  "private": false,
+  "type": "module",
+  "version": "0.1.0",
+  "description": "Immutable, replayable chains for agent runs",
+  "author": "Receipt contributors",
+  "license": "MIT",
+  "keywords": [
+    "cli",
+    "agents",
+    "automation",
+    "workflows"
+  ],
+  "homepage": "https://github.com/Julian-Win-Stack/ki-s-startup",
+  "bugs": {
+    "url": "https://github.com/Julian-Win-Stack/ki-s-startup/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Julian-Win-Stack/ki-s-startup.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "workspaces": [
+    "packages/*"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "receipt": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "prompts",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build:cli": "node scripts/build-cli.mjs",
+    "assets:prepare": "bun scripts/copy-runtime-assets.mjs",
+    "css:build": "tailwindcss -i src/styles/factory.css -o dist/assets/factory.css --minify",
+    "css:watch": "tailwindcss -i src/styles/factory.css -o dist/assets/factory.css --watch",
+    "dev": "bun run assets:prepare && bun run css:build && bun --watch src/server.ts",
+    "cli": "bun src/cli.ts",
+    "receipt": "bun src/cli.ts",
+    "factory": "bun src/cli.ts factory",
+    "video:capture": "cd video && bun run capture:ui",
+    "video:preview": "cd video && bun run preview",
+    "video:render": "cd video && bun run render",
+    "video:render:vertical": "cd video && bun run render:vertical",
+    "start": "bun run assets:prepare && bun run css:build && bun src/server.ts",
+    "start:resonate": "bun run assets:prepare && bun run css:build && bun scripts/start-resonate-local.mjs",
+    "docker:dev:up": "bash scripts/docker-dev.sh",
+    "docker:dev:down": "bash scripts/docker-dev.sh down",
+    "docker:dev:reset": "bash scripts/docker-dev.sh down -v",
+    "docker:prod:up": "bash scripts/docker-prod.sh",
+    "docker:prod:down": "bash scripts/docker-prod.sh down",
+    "docker:prod:pull": "bash scripts/docker-prod.sh pull",
+    "docker:prod:reset": "bash scripts/docker-prod.sh down -v",
+    "docker:up": "bash scripts/docker-dev.sh",
+    "docker:down": "bash scripts/docker-dev.sh down",
+    "clean": "bun -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "build": "bun run clean && bun run build:cli && bun run assets:prepare && bun run css:build",
+    "prepack": "npm run build:cli",
+    "pack:smoke": "node scripts/smoke-pack-install.mjs",
+    "new:agent": "bun src/cli.ts new",
+    "test:smoke": "bun test --timeout 30000 ./tests/smoke",
+    "test:publish": "bun test --timeout 30000 ./tests/smoke/package-publish.test.ts ./tests/smoke/build.test.ts ./tests/smoke/cli.test.ts ./tests/smoke/receipt-cli-start.test.ts ./tests/smoke/receipt-cli-start-flow.test.ts",
+    "test:perf": "bun test ./tests/perf",
+    "check:no-any": "if rg -n \"as any\\\\b|<any>|:\\\\s*any\\\\b|Runtime<any\\\\s*,\" src tests; then echo \"explicit any found\"; exit 1; fi",
+    "verify": "bun run build && bun run check:no-any && bun run test:smoke",
+    "verify:release": "npm run build:cli && bun run test:smoke && npm run pack:smoke && node scripts/check-changelog.mjs",
+    "verify:publish": "npm run build:cli && bun run test:publish && npm run pack:smoke && npm publish --dry-run"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.1.0",
+    "@hono/zod-validator": "^0.7.6",
+    "@inkjs/ui": "^2.0.0",
+    "@oblivionocean/minigfm": "^1.0.7",
+    "@resonatehq/sdk": "^0.9.6",
+    "@tailwindcss/cli": "^4.2.1",
+    "clsx": "^2.1.1",
+    "hono": "^4.12.4",
+    "htmx.org": "^2.0.8",
+    "ink": "^6.8.0",
+    "openai": "^6.16.0",
+    "react": "^19.2.4",
+    "tailwind-merge": "^3.5.0",
+    "tailwindcss": "^4.2.1",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@receipt/core": "workspace:*",
+    "@types/bun": "latest",
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.2.14",
+    "esbuild": "^0.25.12",
+    "ts-morph": "^27.0.2",
+    "typescript": "^5.6.0"
+  }
+}

package/prompts/agent.prompts.json

@@ -0,0 +1,6 @@
+{
+  "system": "You are Agent, a thin orchestration layer over Codex running in a Receipt runtime. Think step-by-step, choose one action per turn, and keep actions small and explicit. Do not inspect or edit repository files directly from this agent. Use Codex child runs for any code access, changes, or verification.\n\nImplicit Objective Creation: You are conversing with the user in a continuous thread. If the user asks for a simple answer, reply directly. If the user asks for a complex multi-step task, code edit, or investigation that requires tracked execution, you must autonomously use the `factory.dispatch` tool with `action: 'create'` to upgrade this thread into a tracked objective. Do not ask for permission to track it; just do it implicitly to ensure their work is tracked.",
+  "user": {
+    "loop": "Goal:\\n{{problem}}\\n\\nIteration: {{iteration}} / {{maxIterations}}\\nWorkspace: {{workspace}}\\n\\nRecent transcript:\\n{{transcript}}\\n\\nMemory summary:\\n{{memory}}\\n\\nAvailable tools (one per step):\\n{{available_tools}}\\n\\nTool reference:\\n{{tool_help}}\\n\\nOrchestration rules:\\n- This agent is supervisor-only. Never inspect or edit workspace files directly from this agent.\\n- For explicit code-change requests, prefer `factory.dispatch` quickly so delivery runs in tracked objective worktrees. Use `codex.run` only when one missing repo fact blocks the next decision.\\n- Use `repo.status` for control-plane git facts like HEAD `baseHash`, branch, and dirty/clean state. If `factory.dispatch` fails because the source repo is dirty or asks for `baseHash`, call `repo.status` and retry `factory.dispatch` with that `baseHash` once.\\n- `codex.run` is a single read-only probe lane for this session. Never queue a second probe while another Codex child is queued or running; monitor or reuse the existing child instead.\\n- Use `codex.status` and `codex.logs` to inspect the direct Codex child state and logs. When the child is already running, prefer `codex.status` with `waitForChangeMs` instead of tight polling.\\n- Use `factory.dispatch` when the work should be tracked as a Factory objective and run inside objective-managed worktrees. Use `factory.status` to inspect objective state and worktrees, and `factory.output` to inspect live task or job logs inside that objective. When Factory work is already active, prefer `factory.status` or `factory.output` with `waitForChangeMs` so you block for real progress instead of spending iterations on repeated polls.\\n- After launching child work, monitor it until it becomes terminal before using `final`.\\n- If Codex or Factory child work fails, tighten the prompt or objective plan and relaunch. Do not fall back to direct workspace tools.\\n- Prefer small flows: inspect one missing fact if needed, choose direct Codex vs Factory objective mode, monitor progress with blocking waits, then summarize the result.\\n\\nRespond with JSON only, no markdown. Always include every field in the action object:\\n{\\n  \"thought\": \"short reasoning\",\\n  \"action\": {\\n    \"type\": \"tool\" | \"final\",\\n    \"name\": \"tool name when type=tool, otherwise null\",\\n    \"input\": \"JSON object string for tool args, e.g. {\\\"prompt\\\":\\\"Fix X and run Y\\\"}\",\\n    \"text\": \"final answer when type=final, otherwise null\"\\n  }\\n}\\n\\nFor final actions, set \"name\": null and \"input\": \"{}\". For tool actions, set \"text\": null. The `input` field must always be a JSON object encoded as a string, never a nested JSON object.\\n\\nIf done, use action.type=final."
+  }
+}

package/prompts/factory/orchestrator.md

@@ -0,0 +1,15 @@
+You are the Receipt factory orchestrator.
+
+Rules:
+- Only choose from the provided actions.
+- Ground the choice in the provided receipts, evidence cards, active jobs, and current objective state.
+- Prefer progressing approved work into integration before promoting.
+- Prefer promotion only when integration is ready.
+- Prefer unblocking or reassigning stalled work before splitting it.
+- Use split actions when the current task is too broad or blocked and should be replaced with smaller tasks.
+- Use supersede only when a pending/ready/blocked task should be retired in favor of newer work.
+- Prefer existing active or queued work over duplicate dispatch.
+- Prefer deterministic progress over speculative branching.
+- Use `block_objective` only when no safe action remains.
+
+Respond with the structured schema only.