@llipe.com/dev-tasks 0.11.0 → 0.16.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/agents/developer.md +138 -62
- package/.claude/agents/github-ops.md +48 -4
- package/.claude/agents/housekeeping.md +44 -7
- package/.claude/agents/qa-engineer.md +24 -11
- package/.claude/agents/researcher.md +26 -6
- package/.claude/agents/technical-writer.md +64 -7
- package/.claude/agents/ux-engineer.md +1 -0
- package/.claude/agents/verifier.md +63 -6
- package/.claude/commands/developer.md +2 -266
- package/.claude/commands/infra-engineer.md +92 -0
- package/.claude/commands/planner.md +98 -29
- package/.claude/commands/product-engineer.md +69 -11
- package/.claude/commands/researcher.md +4 -5
- package/.claude/commands/technical-writer.md +1 -1
- package/.claude/hooks/branch-guard.sh +30 -0
- package/.claude/hooks/git-guard.sh +573 -24
- package/.claude/skills/activity-codebase-research/SKILL.md +4 -11
- package/.claude/skills/activity-generate-spec/SKILL.md +34 -10
- package/.claude/skills/activity-grill/SKILL.md +150 -0
- package/.claude/skills/activity-init/SKILL.md +121 -71
- package/.claude/skills/activity-refine/SKILL.md +75 -15
- package/.claude/skills/activity-test-standards/SKILL.md +25 -0
- package/.claude/skills/aws-ops/SKILL.md +155 -0
- package/.claude/skills/deploy-ops/SKILL.md +121 -0
- package/.claude/skills/fly-ops/SKILL.md +138 -0
- package/.claude/skills/git-ops/SKILL.md +27 -7
- package/.claude/skills/implement/SKILL.md +61 -12
- package/.claude/skills/memo-cli-usage/REFERENCE.md +230 -17
- package/.claude/skills/memo-cli-usage/SKILL.md +68 -13
- package/.claude/skills/plan/SKILL.md +43 -1
- package/.claude/skills/supabase-ops/SKILL.md +109 -0
- package/.github/agents/developer.agent.md +103 -38
- package/.github/agents/github-ops.agent.md +46 -4
- package/.github/agents/housekeeping.agent.md +43 -7
- package/.github/agents/infra-engineer.agent.md +139 -0
- package/.github/agents/planner.agent.md +79 -10
- package/.github/agents/product-engineer.agent.md +69 -11
- package/.github/agents/qa-engineer.agent.md +23 -11
- package/.github/agents/researcher.agent.md +25 -6
- package/.github/agents/technical-writer.agent.md +63 -7
- package/.github/agents/verifier.agent.md +61 -5
- package/.github/instructions/implement.instructions.md +61 -12
- package/.github/instructions/plan.instructions.md +43 -1
- package/.github/prompts/infra-engineer.prompt.md +12 -0
- package/.github/prompts/product-engineer-init.prompt.md +5 -6
- package/.github/prompts/researcher.prompt.md +4 -5
- package/.github/prompts/technical-writer.prompt.md +1 -1
- package/.github/skills/activity-codebase-research/SKILL.md +4 -16
- package/.github/skills/activity-generate-spec/SKILL.md +34 -10
- package/.github/skills/activity-grill/SKILL.md +145 -0
- package/.github/skills/activity-init/SKILL.md +120 -70
- package/.github/skills/activity-refine/SKILL.md +75 -15
- package/.github/skills/activity-test-standards/SKILL.md +25 -0
- package/.github/skills/aws-ops/SKILL.md +150 -0
- package/.github/skills/deploy-ops/SKILL.md +116 -0
- package/.github/skills/fly-ops/SKILL.md +133 -0
- package/.github/skills/git-ops/SKILL.md +27 -7
- package/.github/skills/memo-cli-usage/REFERENCE.md +230 -17
- package/.github/skills/memo-cli-usage/SKILL.md +68 -13
- package/.github/skills/supabase-ops/SKILL.md +104 -0
- package/.kiro/agents/developer.md +104 -39
- package/.kiro/agents/github-ops.md +46 -4
- package/.kiro/agents/housekeeping.md +44 -8
- package/.kiro/agents/infra-engineer.md +102 -0
- package/.kiro/agents/planner.md +87 -21
- package/.kiro/agents/product-engineer.md +72 -14
- package/.kiro/agents/qa-engineer.md +24 -12
- package/.kiro/agents/researcher.md +26 -7
- package/.kiro/agents/technical-writer.md +66 -10
- package/.kiro/agents/verifier.md +62 -6
- package/.kiro/hooks/scripts/git-guard.sh +96 -10
- package/.kiro/skills/activity-codebase-research/SKILL.md +4 -11
- package/.kiro/skills/activity-generate-spec/SKILL.md +34 -10
- package/.kiro/skills/activity-grill/SKILL.md +150 -0
- package/.kiro/skills/activity-init/SKILL.md +121 -71
- package/.kiro/skills/activity-refine/SKILL.md +75 -15
- package/.kiro/skills/activity-test-standards/SKILL.md +25 -0
- package/.kiro/skills/aws-ops/SKILL.md +155 -0
- package/.kiro/skills/deploy-ops/SKILL.md +121 -0
- package/.kiro/skills/fly-ops/SKILL.md +138 -0
- package/.kiro/skills/git-ops/SKILL.md +27 -7
- package/.kiro/skills/memo-cli-usage/REFERENCE.md +230 -17
- package/.kiro/skills/memo-cli-usage/SKILL.md +68 -13
- package/.kiro/skills/supabase-ops/SKILL.md +109 -0
- package/.kiro/steering/implement.md +61 -12
- package/.kiro/steering/plan.md +43 -1
- package/AGENTS.md +67 -114
- package/AGENTS.md.template +126 -0
- package/CHANGELOG.md +182 -0
- package/CLAUDE.md +25 -19
- package/CLAUDE.md.template +104 -0
- package/README.md +168 -146
- package/TESTING.md +84 -148
- package/bundle-manifest.json +43 -2
- package/dist/bin/dev-tasks.js +65 -3
- package/dist/bin/dev-tasks.js.map +1 -1
- package/dist/{adapters/cli → bin}/parse-args.d.ts +2 -6
- package/dist/bin/parse-args.d.ts.map +1 -0
- package/dist/{adapters/cli → bin}/parse-args.js +2 -18
- package/dist/bin/parse-args.js.map +1 -0
- package/dist/core/checks/decision-log-format.d.ts +44 -0
- package/dist/core/checks/decision-log-format.d.ts.map +1 -0
- package/dist/core/checks/decision-log-format.js +171 -0
- package/dist/core/checks/decision-log-format.js.map +1 -0
- package/dist/core/checks/docs-structure.d.ts +82 -0
- package/dist/core/checks/docs-structure.d.ts.map +1 -0
- package/dist/core/checks/docs-structure.js +285 -0
- package/dist/core/checks/docs-structure.js.map +1 -0
- package/dist/core/checks/glossary.d.ts +178 -0
- package/dist/core/checks/glossary.d.ts.map +1 -0
- package/dist/core/checks/glossary.js +651 -0
- package/dist/core/checks/glossary.js.map +1 -0
- package/dist/core/checks/index.d.ts +19 -0
- package/dist/core/checks/index.d.ts.map +1 -0
- package/dist/core/checks/index.js +16 -0
- package/dist/core/checks/index.js.map +1 -0
- package/dist/core/checks/run.d.ts +22 -0
- package/dist/core/checks/run.d.ts.map +1 -0
- package/dist/core/checks/run.js +51 -0
- package/dist/core/checks/run.js.map +1 -0
- package/dist/core/distribution/doctor.d.ts +46 -1
- package/dist/core/distribution/doctor.d.ts.map +1 -1
- package/dist/core/distribution/doctor.js +161 -2
- package/dist/core/distribution/doctor.js.map +1 -1
- package/dist/core/distribution/index.d.ts +9 -3
- package/dist/core/distribution/index.d.ts.map +1 -1
- package/dist/core/distribution/index.js +5 -2
- package/dist/core/distribution/index.js.map +1 -1
- package/dist/core/distribution/install-if-absent.d.ts +46 -0
- package/dist/core/distribution/install-if-absent.d.ts.map +1 -0
- package/dist/core/distribution/install-if-absent.js +81 -0
- package/dist/core/distribution/install-if-absent.js.map +1 -0
- package/dist/core/distribution/install.d.ts.map +1 -1
- package/dist/core/distribution/install.js +5 -0
- package/dist/core/distribution/install.js.map +1 -1
- package/dist/core/distribution/migrate-docs.d.ts +64 -0
- package/dist/core/distribution/migrate-docs.d.ts.map +1 -0
- package/dist/core/distribution/migrate-docs.js +139 -0
- package/dist/core/distribution/migrate-docs.js.map +1 -0
- package/dist/core/distribution/profiles.d.ts +49 -0
- package/dist/core/distribution/profiles.d.ts.map +1 -1
- package/dist/core/distribution/profiles.js +45 -0
- package/dist/core/distribution/profiles.js.map +1 -1
- package/dist/core/distribution/update.d.ts +14 -0
- package/dist/core/distribution/update.d.ts.map +1 -1
- package/dist/core/distribution/update.js +77 -3
- package/dist/core/distribution/update.js.map +1 -1
- package/dist/core/distribution/workspace.d.ts +84 -0
- package/dist/core/distribution/workspace.d.ts.map +1 -0
- package/dist/core/distribution/workspace.js +276 -0
- package/dist/core/distribution/workspace.js.map +1 -0
- package/dist/core/exit-codes.d.ts +15 -35
- package/dist/core/exit-codes.d.ts.map +1 -1
- package/dist/core/exit-codes.js +15 -36
- package/dist/core/exit-codes.js.map +1 -1
- package/dist/core/index.d.ts +1 -6
- package/dist/core/index.d.ts.map +1 -1
- package/dist/core/index.js +1 -7
- package/dist/core/index.js.map +1 -1
- package/package.json +17 -32
- package/templates/claude/settings.json +48 -0
- package/templates/domain/ubiquitous-language.md +28 -0
- package/templates/infra/environments.yaml +16 -0
- package/templates/infra/redaction-patterns.txt +47 -0
- package/templates/runbooks/README.md +14 -0
- package/templates/runbooks/runbook-template.md +40 -0
- package/templates/scripts/deploy-status.sh +89 -0
- package/templates/scripts/deploy-verify.sh +85 -0
- package/templates/scripts/deploy.sh +284 -0
- package/templates/scripts/release.sh +170 -0
- package/templates/scripts/rollback.sh +109 -0
- package/templates/workflows/deploy-dev.yml +66 -0
- package/templates/workflows/deploy-prod.yml +66 -0
- package/templates/workflows/rollback.yml +77 -0
- package/.claude/skills/activity-contract-validation/SKILL.md +0 -167
- package/.github/skills/activity-contract-validation/SKILL.md +0 -167
- package/.kiro/skills/activity-contract-validation/SKILL.md +0 -167
- package/dist/adapters/cli/catalog-build.d.ts +0 -30
- package/dist/adapters/cli/catalog-build.d.ts.map +0 -1
- package/dist/adapters/cli/catalog-build.js +0 -73
- package/dist/adapters/cli/catalog-build.js.map +0 -1
- package/dist/adapters/cli/catalog-query.d.ts +0 -13
- package/dist/adapters/cli/catalog-query.d.ts.map +0 -1
- package/dist/adapters/cli/catalog-query.js +0 -329
- package/dist/adapters/cli/catalog-query.js.map +0 -1
- package/dist/adapters/cli/catalog-scaffold.d.ts +0 -24
- package/dist/adapters/cli/catalog-scaffold.d.ts.map +0 -1
- package/dist/adapters/cli/catalog-scaffold.js +0 -46
- package/dist/adapters/cli/catalog-scaffold.js.map +0 -1
- package/dist/adapters/cli/catalog-validate.d.ts +0 -35
- package/dist/adapters/cli/catalog-validate.d.ts.map +0 -1
- package/dist/adapters/cli/catalog-validate.js +0 -122
- package/dist/adapters/cli/catalog-validate.js.map +0 -1
- package/dist/adapters/cli/ctx-assemble.d.ts +0 -19
- package/dist/adapters/cli/ctx-assemble.d.ts.map +0 -1
- package/dist/adapters/cli/ctx-assemble.js +0 -293
- package/dist/adapters/cli/ctx-assemble.js.map +0 -1
- package/dist/adapters/cli/ctx-fetch.d.ts +0 -49
- package/dist/adapters/cli/ctx-fetch.d.ts.map +0 -1
- package/dist/adapters/cli/ctx-fetch.js +0 -267
- package/dist/adapters/cli/ctx-fetch.js.map +0 -1
- package/dist/adapters/cli/extract-all.d.ts +0 -31
- package/dist/adapters/cli/extract-all.d.ts.map +0 -1
- package/dist/adapters/cli/extract-all.js +0 -374
- package/dist/adapters/cli/extract-all.js.map +0 -1
- package/dist/adapters/cli/extract-asyncapi.d.ts +0 -26
- package/dist/adapters/cli/extract-asyncapi.d.ts.map +0 -1
- package/dist/adapters/cli/extract-asyncapi.js +0 -142
- package/dist/adapters/cli/extract-asyncapi.js.map +0 -1
- package/dist/adapters/cli/extract-component.d.ts +0 -24
- package/dist/adapters/cli/extract-component.d.ts.map +0 -1
- package/dist/adapters/cli/extract-component.js +0 -198
- package/dist/adapters/cli/extract-component.js.map +0 -1
- package/dist/adapters/cli/extract-detect.d.ts +0 -19
- package/dist/adapters/cli/extract-detect.d.ts.map +0 -1
- package/dist/adapters/cli/extract-detect.js +0 -98
- package/dist/adapters/cli/extract-detect.js.map +0 -1
- package/dist/adapters/cli/extract-openapi.d.ts +0 -29
- package/dist/adapters/cli/extract-openapi.d.ts.map +0 -1
- package/dist/adapters/cli/extract-openapi.js +0 -111
- package/dist/adapters/cli/extract-openapi.js.map +0 -1
- package/dist/adapters/cli/extract-schema.d.ts +0 -15
- package/dist/adapters/cli/extract-schema.d.ts.map +0 -1
- package/dist/adapters/cli/extract-schema.js +0 -39
- package/dist/adapters/cli/extract-schema.js.map +0 -1
- package/dist/adapters/cli/index.d.ts +0 -6
- package/dist/adapters/cli/index.d.ts.map +0 -1
- package/dist/adapters/cli/index.js +0 -5
- package/dist/adapters/cli/index.js.map +0 -1
- package/dist/adapters/cli/init.d.ts +0 -37
- package/dist/adapters/cli/init.d.ts.map +0 -1
- package/dist/adapters/cli/init.js +0 -336
- package/dist/adapters/cli/init.js.map +0 -1
- package/dist/adapters/cli/parse-args.d.ts.map +0 -1
- package/dist/adapters/cli/parse-args.js.map +0 -1
- package/dist/adapters/cli/scope-gate.d.ts +0 -25
- package/dist/adapters/cli/scope-gate.d.ts.map +0 -1
- package/dist/adapters/cli/scope-gate.js +0 -157
- package/dist/adapters/cli/scope-gate.js.map +0 -1
- package/dist/adapters/cli/scope.d.ts +0 -26
- package/dist/adapters/cli/scope.d.ts.map +0 -1
- package/dist/adapters/cli/scope.js +0 -172
- package/dist/adapters/cli/scope.js.map +0 -1
- package/dist/adapters/cli/validate-component.d.ts +0 -24
- package/dist/adapters/cli/validate-component.d.ts.map +0 -1
- package/dist/adapters/cli/validate-component.js +0 -62
- package/dist/adapters/cli/validate-component.js.map +0 -1
- package/dist/adapters/cli/verify-contract-diff.d.ts +0 -21
- package/dist/adapters/cli/verify-contract-diff.d.ts.map +0 -1
- package/dist/adapters/cli/verify-contract-diff.js +0 -69
- package/dist/adapters/cli/verify-contract-diff.js.map +0 -1
- package/dist/adapters/cli/verify-drift.d.ts +0 -24
- package/dist/adapters/cli/verify-drift.d.ts.map +0 -1
- package/dist/adapters/cli/verify-drift.js +0 -103
- package/dist/adapters/cli/verify-drift.js.map +0 -1
- package/dist/adapters/cli/verify-impact.d.ts +0 -23
- package/dist/adapters/cli/verify-impact.d.ts.map +0 -1
- package/dist/adapters/cli/verify-impact.js +0 -119
- package/dist/adapters/cli/verify-impact.js.map +0 -1
- package/dist/adapters/mcp/index.d.ts +0 -5
- package/dist/adapters/mcp/index.d.ts.map +0 -1
- package/dist/adapters/mcp/index.js +0 -2
- package/dist/adapters/mcp/index.js.map +0 -1
- package/dist/bin/dt.d.ts +0 -7
- package/dist/bin/dt.d.ts.map +0 -1
- package/dist/bin/dt.js +0 -647
- package/dist/bin/dt.js.map +0 -1
- package/dist/core/catalog/build.d.ts +0 -143
- package/dist/core/catalog/build.d.ts.map +0 -1
- package/dist/core/catalog/build.js +0 -475
- package/dist/core/catalog/build.js.map +0 -1
- package/dist/core/catalog/checks/index.d.ts +0 -18
- package/dist/core/catalog/checks/index.d.ts.map +0 -1
- package/dist/core/catalog/checks/index.js +0 -18
- package/dist/core/catalog/checks/index.js.map +0 -1
- package/dist/core/catalog/checks/v01-schema.d.ts +0 -17
- package/dist/core/catalog/checks/v01-schema.d.ts.map +0 -1
- package/dist/core/catalog/checks/v01-schema.js +0 -57
- package/dist/core/catalog/checks/v01-schema.js.map +0 -1
- package/dist/core/catalog/checks/v02-v03-identity.d.ts +0 -14
- package/dist/core/catalog/checks/v02-v03-identity.d.ts.map +0 -1
- package/dist/core/catalog/checks/v02-v03-identity.js +0 -60
- package/dist/core/catalog/checks/v02-v03-identity.js.map +0 -1
- package/dist/core/catalog/checks/v04-referential-integrity.d.ts +0 -7
- package/dist/core/catalog/checks/v04-referential-integrity.d.ts.map +0 -1
- package/dist/core/catalog/checks/v04-referential-integrity.js +0 -32
- package/dist/core/catalog/checks/v04-referential-integrity.js.map +0 -1
- package/dist/core/catalog/checks/v05-domain-existence.d.ts +0 -6
- package/dist/core/catalog/checks/v05-domain-existence.d.ts.map +0 -1
- package/dist/core/catalog/checks/v05-domain-existence.js +0 -23
- package/dist/core/catalog/checks/v05-domain-existence.js.map +0 -1
- package/dist/core/catalog/checks/v06-v07-paths.d.ts +0 -29
- package/dist/core/catalog/checks/v06-v07-paths.d.ts.map +0 -1
- package/dist/core/catalog/checks/v06-v07-paths.js +0 -107
- package/dist/core/catalog/checks/v06-v07-paths.js.map +0 -1
- package/dist/core/catalog/checks/v08-v10-contracts.d.ts +0 -13
- package/dist/core/catalog/checks/v08-v10-contracts.d.ts.map +0 -1
- package/dist/core/catalog/checks/v08-v10-contracts.js +0 -70
- package/dist/core/catalog/checks/v08-v10-contracts.js.map +0 -1
- package/dist/core/catalog/checks/v11-manual-fields.d.ts +0 -16
- package/dist/core/catalog/checks/v11-manual-fields.d.ts.map +0 -1
- package/dist/core/catalog/checks/v11-manual-fields.js +0 -60
- package/dist/core/catalog/checks/v11-manual-fields.js.map +0 -1
- package/dist/core/catalog/checks/v12-cycles.d.ts +0 -8
- package/dist/core/catalog/checks/v12-cycles.d.ts.map +0 -1
- package/dist/core/catalog/checks/v12-cycles.js +0 -28
- package/dist/core/catalog/checks/v12-cycles.js.map +0 -1
- package/dist/core/catalog/checks/v13-orphan-contracts.d.ts +0 -7
- package/dist/core/catalog/checks/v13-orphan-contracts.d.ts.map +0 -1
- package/dist/core/catalog/checks/v13-orphan-contracts.js +0 -33
- package/dist/core/catalog/checks/v13-orphan-contracts.js.map +0 -1
- package/dist/core/catalog/checks/v14-v15-lifecycle.d.ts +0 -8
- package/dist/core/catalog/checks/v14-v15-lifecycle.d.ts.map +0 -1
- package/dist/core/catalog/checks/v14-v15-lifecycle.js +0 -42
- package/dist/core/catalog/checks/v14-v15-lifecycle.js.map +0 -1
- package/dist/core/catalog/checks/v16-deprecated-consumers.d.ts +0 -7
- package/dist/core/catalog/checks/v16-deprecated-consumers.d.ts.map +0 -1
- package/dist/core/catalog/checks/v16-deprecated-consumers.js +0 -47
- package/dist/core/catalog/checks/v16-deprecated-consumers.js.map +0 -1
- package/dist/core/catalog/checks/v17-low-confidence.d.ts +0 -7
- package/dist/core/catalog/checks/v17-low-confidence.d.ts.map +0 -1
- package/dist/core/catalog/checks/v17-low-confidence.js +0 -32
- package/dist/core/catalog/checks/v17-low-confidence.js.map +0 -1
- package/dist/core/catalog/checks/v18-low-payload.d.ts +0 -7
- package/dist/core/catalog/checks/v18-low-payload.d.ts.map +0 -1
- package/dist/core/catalog/checks/v18-low-payload.js +0 -33
- package/dist/core/catalog/checks/v18-low-payload.js.map +0 -1
- package/dist/core/catalog/checks/v19-domain-membership.d.ts +0 -8
- package/dist/core/catalog/checks/v19-domain-membership.d.ts.map +0 -1
- package/dist/core/catalog/checks/v19-domain-membership.js +0 -55
- package/dist/core/catalog/checks/v19-domain-membership.js.map +0 -1
- package/dist/core/catalog/coverage.d.ts +0 -39
- package/dist/core/catalog/coverage.d.ts.map +0 -1
- package/dist/core/catalog/coverage.js +0 -62
- package/dist/core/catalog/coverage.js.map +0 -1
- package/dist/core/catalog/graph.d.ts +0 -49
- package/dist/core/catalog/graph.d.ts.map +0 -1
- package/dist/core/catalog/graph.js +0 -114
- package/dist/core/catalog/graph.js.map +0 -1
- package/dist/core/catalog/index-model.d.ts +0 -96
- package/dist/core/catalog/index-model.d.ts.map +0 -1
- package/dist/core/catalog/index-model.js +0 -8
- package/dist/core/catalog/index-model.js.map +0 -1
- package/dist/core/catalog/index.d.ts +0 -5
- package/dist/core/catalog/index.d.ts.map +0 -1
- package/dist/core/catalog/index.js +0 -2
- package/dist/core/catalog/index.js.map +0 -1
- package/dist/core/catalog/queries.d.ts +0 -69
- package/dist/core/catalog/queries.d.ts.map +0 -1
- package/dist/core/catalog/queries.js +0 -165
- package/dist/core/catalog/queries.js.map +0 -1
- package/dist/core/catalog/resolve.d.ts +0 -47
- package/dist/core/catalog/resolve.d.ts.map +0 -1
- package/dist/core/catalog/resolve.js +0 -318
- package/dist/core/catalog/resolve.js.map +0 -1
- package/dist/core/catalog/scaffold.d.ts +0 -31
- package/dist/core/catalog/scaffold.d.ts.map +0 -1
- package/dist/core/catalog/scaffold.js +0 -141
- package/dist/core/catalog/scaffold.js.map +0 -1
- package/dist/core/catalog/validate-component.d.ts +0 -50
- package/dist/core/catalog/validate-component.d.ts.map +0 -1
- package/dist/core/catalog/validate-component.js +0 -105
- package/dist/core/catalog/validate-component.js.map +0 -1
- package/dist/core/catalog/validate.d.ts +0 -71
- package/dist/core/catalog/validate.d.ts.map +0 -1
- package/dist/core/catalog/validate.js +0 -103
- package/dist/core/catalog/validate.js.map +0 -1
- package/dist/core/context/assemble.d.ts +0 -126
- package/dist/core/context/assemble.d.ts.map +0 -1
- package/dist/core/context/assemble.js +0 -197
- package/dist/core/context/assemble.js.map +0 -1
- package/dist/core/context/cache.d.ts +0 -60
- package/dist/core/context/cache.d.ts.map +0 -1
- package/dist/core/context/cache.js +0 -236
- package/dist/core/context/cache.js.map +0 -1
- package/dist/core/context/exit-codes.d.ts +0 -28
- package/dist/core/context/exit-codes.d.ts.map +0 -1
- package/dist/core/context/exit-codes.js +0 -28
- package/dist/core/context/exit-codes.js.map +0 -1
- package/dist/core/context/fetch.d.ts +0 -55
- package/dist/core/context/fetch.d.ts.map +0 -1
- package/dist/core/context/fetch.js +0 -112
- package/dist/core/context/fetch.js.map +0 -1
- package/dist/core/context/index.d.ts +0 -11
- package/dist/core/context/index.d.ts.map +0 -1
- package/dist/core/context/index.js +0 -8
- package/dist/core/context/index.js.map +0 -1
- package/dist/core/context/init.d.ts +0 -179
- package/dist/core/context/init.d.ts.map +0 -1
- package/dist/core/context/init.js +0 -532
- package/dist/core/context/init.js.map +0 -1
- package/dist/core/context/layers/architecture-layer.d.ts +0 -13
- package/dist/core/context/layers/architecture-layer.d.ts.map +0 -1
- package/dist/core/context/layers/architecture-layer.js +0 -24
- package/dist/core/context/layers/architecture-layer.js.map +0 -1
- package/dist/core/context/layers/contracts-layer.d.ts +0 -13
- package/dist/core/context/layers/contracts-layer.d.ts.map +0 -1
- package/dist/core/context/layers/contracts-layer.js +0 -83
- package/dist/core/context/layers/contracts-layer.js.map +0 -1
- package/dist/core/context/layers/conventions-delta-layer.d.ts +0 -13
- package/dist/core/context/layers/conventions-delta-layer.d.ts.map +0 -1
- package/dist/core/context/layers/conventions-delta-layer.js +0 -37
- package/dist/core/context/layers/conventions-delta-layer.js.map +0 -1
- package/dist/core/context/layers/flow-layer.d.ts +0 -14
- package/dist/core/context/layers/flow-layer.d.ts.map +0 -1
- package/dist/core/context/layers/flow-layer.js +0 -61
- package/dist/core/context/layers/flow-layer.js.map +0 -1
- package/dist/core/context/layers/index-layer.d.ts +0 -13
- package/dist/core/context/layers/index-layer.d.ts.map +0 -1
- package/dist/core/context/layers/index-layer.js +0 -77
- package/dist/core/context/layers/index-layer.js.map +0 -1
- package/dist/core/context/layers/primary-layer.d.ts +0 -16
- package/dist/core/context/layers/primary-layer.d.ts.map +0 -1
- package/dist/core/context/layers/primary-layer.js +0 -61
- package/dist/core/context/layers/primary-layer.js.map +0 -1
- package/dist/core/context/layers/secondary-layer.d.ts +0 -19
- package/dist/core/context/layers/secondary-layer.d.ts.map +0 -1
- package/dist/core/context/layers/secondary-layer.js +0 -52
- package/dist/core/context/layers/secondary-layer.js.map +0 -1
- package/dist/core/context/session-lock.d.ts +0 -114
- package/dist/core/context/session-lock.d.ts.map +0 -1
- package/dist/core/context/session-lock.js +0 -90
- package/dist/core/context/session-lock.js.map +0 -1
- package/dist/core/context/tokens.d.ts +0 -35
- package/dist/core/context/tokens.d.ts.map +0 -1
- package/dist/core/context/tokens.js +0 -88
- package/dist/core/context/tokens.js.map +0 -1
- package/dist/core/extract/asyncapi/declared.d.ts +0 -19
- package/dist/core/extract/asyncapi/declared.d.ts.map +0 -1
- package/dist/core/extract/asyncapi/declared.js +0 -168
- package/dist/core/extract/asyncapi/declared.js.map +0 -1
- package/dist/core/extract/asyncapi/index.d.ts +0 -12
- package/dist/core/extract/asyncapi/index.d.ts.map +0 -1
- package/dist/core/extract/asyncapi/index.js +0 -8
- package/dist/core/extract/asyncapi/index.js.map +0 -1
- package/dist/core/extract/asyncapi/payloads.d.ts +0 -20
- package/dist/core/extract/asyncapi/payloads.d.ts.map +0 -1
- package/dist/core/extract/asyncapi/payloads.js +0 -421
- package/dist/core/extract/asyncapi/payloads.js.map +0 -1
- package/dist/core/extract/asyncapi/topics.d.ts +0 -27
- package/dist/core/extract/asyncapi/topics.d.ts.map +0 -1
- package/dist/core/extract/asyncapi/topics.js +0 -368
- package/dist/core/extract/asyncapi/topics.js.map +0 -1
- package/dist/core/extract/asyncapi/types.d.ts +0 -129
- package/dist/core/extract/asyncapi/types.d.ts.map +0 -1
- package/dist/core/extract/asyncapi/types.js +0 -5
- package/dist/core/extract/asyncapi/types.js.map +0 -1
- package/dist/core/extract/asyncapi/validate.d.ts +0 -29
- package/dist/core/extract/asyncapi/validate.d.ts.map +0 -1
- package/dist/core/extract/asyncapi/validate.js +0 -156
- package/dist/core/extract/asyncapi/validate.js.map +0 -1
- package/dist/core/extract/component.d.ts +0 -204
- package/dist/core/extract/component.d.ts.map +0 -1
- package/dist/core/extract/component.js +0 -258
- package/dist/core/extract/component.js.map +0 -1
- package/dist/core/extract/detect.d.ts +0 -35
- package/dist/core/extract/detect.d.ts.map +0 -1
- package/dist/core/extract/detect.js +0 -89
- package/dist/core/extract/detect.js.map +0 -1
- package/dist/core/extract/index.d.ts +0 -12
- package/dist/core/extract/index.d.ts.map +0 -1
- package/dist/core/extract/index.js +0 -6
- package/dist/core/extract/index.js.map +0 -1
- package/dist/core/extract/ladder.d.ts +0 -79
- package/dist/core/extract/ladder.d.ts.map +0 -1
- package/dist/core/extract/ladder.js +0 -70
- package/dist/core/extract/ladder.js.map +0 -1
- package/dist/core/extract/openapi/index.d.ts +0 -43
- package/dist/core/extract/openapi/index.d.ts.map +0 -1
- package/dist/core/extract/openapi/index.js +0 -142
- package/dist/core/extract/openapi/index.js.map +0 -1
- package/dist/core/extract/openapi/route1.d.ts +0 -36
- package/dist/core/extract/openapi/route1.d.ts.map +0 -1
- package/dist/core/extract/openapi/route1.js +0 -333
- package/dist/core/extract/openapi/route1.js.map +0 -1
- package/dist/core/extract/openapi/route2-introspect.d.ts +0 -18
- package/dist/core/extract/openapi/route2-introspect.d.ts.map +0 -1
- package/dist/core/extract/openapi/route2-introspect.js +0 -249
- package/dist/core/extract/openapi/route2-introspect.js.map +0 -1
- package/dist/core/extract/openapi/route2.d.ts +0 -69
- package/dist/core/extract/openapi/route2.d.ts.map +0 -1
- package/dist/core/extract/openapi/route2.js +0 -211
- package/dist/core/extract/openapi/route2.js.map +0 -1
- package/dist/core/extract/openapi/route3.d.ts +0 -26
- package/dist/core/extract/openapi/route3.d.ts.map +0 -1
- package/dist/core/extract/openapi/route3.js +0 -737
- package/dist/core/extract/openapi/route3.js.map +0 -1
- package/dist/core/extract/openapi/types.d.ts +0 -125
- package/dist/core/extract/openapi/types.d.ts.map +0 -1
- package/dist/core/extract/openapi/types.js +0 -5
- package/dist/core/extract/openapi/types.js.map +0 -1
- package/dist/core/extract/openapi/validate.d.ts +0 -29
- package/dist/core/extract/openapi/validate.d.ts.map +0 -1
- package/dist/core/extract/openapi/validate.js +0 -200
- package/dist/core/extract/openapi/validate.js.map +0 -1
- package/dist/core/extract/orm/drizzle.d.ts +0 -20
- package/dist/core/extract/orm/drizzle.d.ts.map +0 -1
- package/dist/core/extract/orm/drizzle.js +0 -283
- package/dist/core/extract/orm/drizzle.js.map +0 -1
- package/dist/core/extract/orm/information-schema.d.ts +0 -26
- package/dist/core/extract/orm/information-schema.d.ts.map +0 -1
- package/dist/core/extract/orm/information-schema.js +0 -142
- package/dist/core/extract/orm/information-schema.js.map +0 -1
- package/dist/core/extract/orm/prisma.d.ts +0 -23
- package/dist/core/extract/orm/prisma.d.ts.map +0 -1
- package/dist/core/extract/orm/prisma.js +0 -234
- package/dist/core/extract/orm/prisma.js.map +0 -1
- package/dist/core/extract/orm/typeorm.d.ts +0 -22
- package/dist/core/extract/orm/typeorm.d.ts.map +0 -1
- package/dist/core/extract/orm/typeorm.js +0 -269
- package/dist/core/extract/orm/typeorm.js.map +0 -1
- package/dist/core/extract/orm/types.d.ts +0 -97
- package/dist/core/extract/orm/types.d.ts.map +0 -1
- package/dist/core/extract/orm/types.js +0 -6
- package/dist/core/extract/orm/types.js.map +0 -1
- package/dist/core/extract/prompt.d.ts +0 -21
- package/dist/core/extract/prompt.d.ts.map +0 -1
- package/dist/core/extract/prompt.js +0 -79
- package/dist/core/extract/prompt.js.map +0 -1
- package/dist/core/extract/provider.d.ts +0 -121
- package/dist/core/extract/provider.d.ts.map +0 -1
- package/dist/core/extract/provider.js +0 -6
- package/dist/core/extract/provider.js.map +0 -1
- package/dist/core/extract/providers/node-ts.d.ts +0 -69
- package/dist/core/extract/providers/node-ts.d.ts.map +0 -1
- package/dist/core/extract/providers/node-ts.js +0 -320
- package/dist/core/extract/providers/node-ts.js.map +0 -1
- package/dist/core/extract/render/schema-md.d.ts +0 -16
- package/dist/core/extract/render/schema-md.d.ts.map +0 -1
- package/dist/core/extract/render/schema-md.js +0 -140
- package/dist/core/extract/render/schema-md.js.map +0 -1
- package/dist/core/extract/report.d.ts +0 -125
- package/dist/core/extract/report.d.ts.map +0 -1
- package/dist/core/extract/report.js +0 -52
- package/dist/core/extract/report.js.map +0 -1
- package/dist/core/extract/schema.d.ts +0 -34
- package/dist/core/extract/schema.d.ts.map +0 -1
- package/dist/core/extract/schema.js +0 -146
- package/dist/core/extract/schema.js.map +0 -1
- package/dist/core/extract/workspaces.d.ts +0 -33
- package/dist/core/extract/workspaces.d.ts.map +0 -1
- package/dist/core/extract/workspaces.js +0 -193
- package/dist/core/extract/workspaces.js.map +0 -1
- package/dist/core/providers/index.d.ts +0 -6
- package/dist/core/providers/index.d.ts.map +0 -1
- package/dist/core/providers/index.js +0 -2
- package/dist/core/providers/index.js.map +0 -1
- package/dist/core/providers/tracker.d.ts +0 -74
- package/dist/core/providers/tracker.d.ts.map +0 -1
- package/dist/core/providers/tracker.js +0 -38
- package/dist/core/providers/tracker.js.map +0 -1
- package/dist/core/scope/calibration.d.ts +0 -25
- package/dist/core/scope/calibration.d.ts.map +0 -1
- package/dist/core/scope/calibration.js +0 -52
- package/dist/core/scope/calibration.js.map +0 -1
- package/dist/core/scope/closure.d.ts +0 -31
- package/dist/core/scope/closure.d.ts.map +0 -1
- package/dist/core/scope/closure.js +0 -68
- package/dist/core/scope/closure.js.map +0 -1
- package/dist/core/scope/gate.d.ts +0 -41
- package/dist/core/scope/gate.d.ts.map +0 -1
- package/dist/core/scope/gate.js +0 -165
- package/dist/core/scope/gate.js.map +0 -1
- package/dist/core/scope/index.d.ts +0 -18
- package/dist/core/scope/index.d.ts.map +0 -1
- package/dist/core/scope/index.js +0 -12
- package/dist/core/scope/index.js.map +0 -1
- package/dist/core/scope/partition.d.ts +0 -36
- package/dist/core/scope/partition.d.ts.map +0 -1
- package/dist/core/scope/partition.js +0 -78
- package/dist/core/scope/partition.js.map +0 -1
- package/dist/core/scope/prompt.d.ts +0 -39
- package/dist/core/scope/prompt.d.ts.map +0 -1
- package/dist/core/scope/prompt.js +0 -123
- package/dist/core/scope/prompt.js.map +0 -1
- package/dist/core/scope/scoping.d.ts +0 -52
- package/dist/core/scope/scoping.d.ts.map +0 -1
- package/dist/core/scope/scoping.js +0 -99
- package/dist/core/scope/scoping.js.map +0 -1
- package/dist/core/scope/types.d.ts +0 -77
- package/dist/core/scope/types.d.ts.map +0 -1
- package/dist/core/scope/types.js +0 -5
- package/dist/core/scope/types.js.map +0 -1
- package/dist/core/scope/validate.d.ts +0 -47
- package/dist/core/scope/validate.d.ts.map +0 -1
- package/dist/core/scope/validate.js +0 -90
- package/dist/core/scope/validate.js.map +0 -1
- package/dist/core/verify/asyncapi-diff.d.ts +0 -34
- package/dist/core/verify/asyncapi-diff.d.ts.map +0 -1
- package/dist/core/verify/asyncapi-diff.js +0 -209
- package/dist/core/verify/asyncapi-diff.js.map +0 -1
- package/dist/core/verify/contract-diff.d.ts +0 -39
- package/dist/core/verify/contract-diff.d.ts.map +0 -1
- package/dist/core/verify/contract-diff.js +0 -63
- package/dist/core/verify/contract-diff.js.map +0 -1
- package/dist/core/verify/drift.d.ts +0 -47
- package/dist/core/verify/drift.d.ts.map +0 -1
- package/dist/core/verify/drift.js +0 -122
- package/dist/core/verify/drift.js.map +0 -1
- package/dist/core/verify/impact.d.ts +0 -22
- package/dist/core/verify/impact.d.ts.map +0 -1
- package/dist/core/verify/impact.js +0 -93
- package/dist/core/verify/impact.js.map +0 -1
- package/dist/core/verify/index.d.ts +0 -10
- package/dist/core/verify/index.d.ts.map +0 -1
- package/dist/core/verify/index.js +0 -9
- package/dist/core/verify/index.js.map +0 -1
- package/dist/core/verify/openapi-diff.d.ts +0 -29
- package/dist/core/verify/openapi-diff.d.ts.map +0 -1
- package/dist/core/verify/openapi-diff.js +0 -291
- package/dist/core/verify/openapi-diff.js.map +0 -1
- package/dist/core/verify/types.d.ts +0 -138
- package/dist/core/verify/types.d.ts.map +0 -1
- package/dist/core/verify/types.js +0 -5
- package/dist/core/verify/types.js.map +0 -1
- package/schemas/component.schema.json +0 -203
- package/schemas/flow.schema.json +0 -75
- package/schemas/scope-output.schema.json +0 -62
|
@@ -34,7 +34,7 @@ git checkout -b <branch-name>
|
|
|
34
34
|
|
|
35
35
|
- Story branches: `story/<story-id>-<short-description>`
|
|
36
36
|
- Issue branches: `issue/<issue-number>-<short-description>`
|
|
37
|
-
- Integration branches: `
|
|
37
|
+
- Integration branches: `integration/<plan-id>-<short-description>`
|
|
38
38
|
|
|
39
39
|
### 2. Create Branch from Integration Branch
|
|
40
40
|
|
|
@@ -91,13 +91,13 @@ Before merging any PR or branch, verify:
|
|
|
91
91
|
|
|
92
92
|
Choose the appropriate strategy based on context:
|
|
93
93
|
|
|
94
|
-
| Strategy | When to Use | Command
|
|
95
|
-
| ---------------- | ----------------------------------------------------------------------------------- |
|
|
96
|
-
| **Squash merge** |
|
|
97
|
-
| **Merge commit** | Integration
|
|
98
|
-
| **Rebase merge** |
|
|
94
|
+
| Strategy | When to Use | Command |
|
|
95
|
+
| ---------------- | ----------------------------------------------------------------------------------- | ------------------------------------------- |
|
|
96
|
+
| **Squash merge** | Issue/story PRs → integration (planner) or `main` (user); delete the source branch. | `gh pr merge <pr> --squash --delete-branch` |
|
|
97
|
+
| **Merge commit** | Integration PRs → `main` (user); preserve the story history. | `gh pr merge <pr> --merge` |
|
|
98
|
+
| **Rebase merge** | Not part of the issue/story/integration policy; use only when explicitly approved. | `gh pr merge <pr> --rebase` |
|
|
99
99
|
|
|
100
|
-
**Default**:
|
|
100
|
+
**Default**: Issue/story PRs use squash with branch deletion; integration PRs use a merge commit. Planner handles integration targets, and the user handles `main`.
|
|
101
101
|
|
|
102
102
|
### 6. Resolve Merge Conflicts
|
|
103
103
|
|
|
@@ -192,6 +192,26 @@ git push --force-with-lease origin <branch-name>
|
|
|
192
192
|
|
|
193
193
|
**Never use** `git push --force` without `--with-lease`.
|
|
194
194
|
|
|
195
|
+
### 10. Tag Procedure (Human-Only)
|
|
196
|
+
|
|
197
|
+
Tags are the production deploy trigger and are created **only by a human**. Agents **MUST NOT** create, move, delete, or push tags; `git-guard` rule 4 enforces this. This section documents the procedure a human follows — it is not an agent action.
|
|
198
|
+
|
|
199
|
+
```bash
|
|
200
|
+
# Ensure you are on main at the exact release commit
|
|
201
|
+
git checkout main
|
|
202
|
+
git pull origin main
|
|
203
|
+
|
|
204
|
+
# Create an annotated, immutable release tag (exact semver only)
|
|
205
|
+
git tag -a v<major>.<minor>.<patch> -m "Release v<major>.<minor>.<patch>"
|
|
206
|
+
|
|
207
|
+
# Push the tag (triggers the production deploy workflow)
|
|
208
|
+
git push origin v<major>.<minor>.<patch>
|
|
209
|
+
```
|
|
210
|
+
|
|
211
|
+
Rules: annotated tags only (never lightweight), exact `v<major>.<minor>.<patch>` (no prerelease suffixes in v1), tag a commit on `main`, and never move or delete a pushed tag.
|
|
212
|
+
|
|
213
|
+
**Hotfix:** a hotfix ships as the next patch tag (`vX.Y.Z+1`) cut from `main` after the fix merges; never re-point or force-update an existing tag.
|
|
214
|
+
|
|
195
215
|
---
|
|
196
216
|
|
|
197
217
|
## Conflict Resolution Heuristics
|
|
@@ -249,6 +249,36 @@ Every entry belongs to a **repo**, **org**, and **domain** (all kebab-case). Que
|
|
|
249
249
|
|
|
250
250
|
---
|
|
251
251
|
|
|
252
|
+
## Banks, Kinds, and Session Memory (memo-cli 1.3.0+)
|
|
253
|
+
|
|
254
|
+
memo-cli 1.3.0 adds a second axis of scoping — **banks** — and a third field on every entry — **kind** — on top of the repo/org/domain scoping above. Every command example in this section was verified against the local 1.3.0 build's `--help` output (`pnpm build && node dist/index.js <cmd> --help`).
|
|
255
|
+
|
|
256
|
+
### `bank` — Namespace
|
|
257
|
+
|
|
258
|
+
A bank is a namespace for entries, resolved in this priority order (B3): `--bank <id>` flag > `$MEMO_BANK` env var > `config.bank.default` > `kb`. `kb` is the shared, org-wide knowledge base every repo reads from by default; any other bank id (kebab-case or UUID) is a **private** bank — conventionally named `<agent-name>-memory` (e.g. `developer-memory`, `technical-writer-memory`, `product-engineer-memory`, `planner-memory`) for a long-lived agent's own session memory.
|
|
259
|
+
|
|
260
|
+
**Agents: always pass `--bank <id>` literally on every command.** Agent runtimes run each shell command in a fresh shell, so an `export MEMO_BANK=…` from an earlier command is gone by the next one. An unquoted empty `$MEMO_BANK` is dropped by the shell, and the flag parser then reads the next token as the bank id (`--bank --rationale …` → bank `--rationale`), which memo-cli rejects with `VALIDATION_FAILED` (dev-tasks issue #253). Never write `--bank $MEMO_BANK` in an agent prompt or command.
|
|
261
|
+
|
|
262
|
+
```bash
|
|
263
|
+
memo write --bank developer-memory ... # bank id convention: <agent-name>-memory
|
|
264
|
+
```
|
|
265
|
+
|
|
266
|
+
`kb` and private banks are isolated from each other: a `search`/`list`/`recall` scoped to a private bank never returns `kb` entries and vice versa, unless you explicitly pass `--bank kb`.
|
|
267
|
+
|
|
268
|
+
### `kind` — Entry Nature
|
|
269
|
+
|
|
270
|
+
| Kind | Meaning | Where it lives | Expires? |
|
|
271
|
+
| ---------- | ------------------------------------------------------------------------- | ----------------------------------------------------------- | ---------------------------------------------------- |
|
|
272
|
+
| `self` | The agent's own persona/context entries (never ranked, never trimmed) | private banks only — `kb` rejects `--kind self` | no (subject to a soft cap warning, not a hard block) |
|
|
273
|
+
| `episodic` | Session-scoped narration — intent/outcome entries tied to one `--session` | private banks (default kind there) | yes — `policy.expires_in_days` or `--expires-in` |
|
|
274
|
+
| `semantic` | Durable, searchable decisions — what `search`/`list` return by default | `kb` (default kind there); may also exist in a private bank | no |
|
|
275
|
+
|
|
276
|
+
`--kind` is case-insensitive (`--kind Self`, `--kind SELF`, `--kind self` all normalize to `self`). Default kind is `episodic` in a private bank, `semantic` in `kb`.
|
|
277
|
+
|
|
278
|
+
**Rule of thumb for agent definitions in this repository:** intent/outcome entries are `--kind episodic --session ISSUE-<n> --bank <agent>-memory`; ADR/decision entries stay `--kind semantic --bank kb`.
|
|
279
|
+
|
|
280
|
+
---
|
|
281
|
+
|
|
252
282
|
## Command Reference
|
|
253
283
|
|
|
254
284
|
### `memo write` — Record a Decision
|
|
@@ -262,6 +292,22 @@ memo write \
|
|
|
262
292
|
--json
|
|
263
293
|
```
|
|
264
294
|
|
|
295
|
+
Episodic example — intent entry in a private bank:
|
|
296
|
+
|
|
297
|
+
```bash
|
|
298
|
+
memo write \
|
|
299
|
+
--kind episodic \
|
|
300
|
+
--session ISSUE-42 \
|
|
301
|
+
--bank <agent>-memory \
|
|
302
|
+
--rationale "Context: Starting ISSUE-42. Decision: implement via a middleware. Impact: affects the auth pipeline." \
|
|
303
|
+
--tags "auth,issue-42,intent,middleware" \
|
|
304
|
+
--entry-type decision \
|
|
305
|
+
--source agent \
|
|
306
|
+
--story "ISSUE-42" \
|
|
307
|
+
--on-duplicate consolidate \
|
|
308
|
+
--json
|
|
309
|
+
```
|
|
310
|
+
|
|
265
311
|
**Required flags:**
|
|
266
312
|
|
|
267
313
|
- `--rationale` — The decision text (1–5 000 chars).
|
|
@@ -269,17 +315,29 @@ memo write \
|
|
|
269
315
|
|
|
270
316
|
**Optional flags:**
|
|
271
317
|
|
|
272
|
-
- `--entry-type` — `decision` (default) | `integration_point` | `structure`
|
|
273
|
-
- `--source` — `agent` | `manual` (falls back to config default)
|
|
318
|
+
- `--entry-type` — `decision` (default) | `integration_point` | `structure` | `policy` | `observation` (default `observation` when `--kind episodic`)
|
|
319
|
+
- `--source` — `agent` | `manual` | `scan` (falls back to config default)
|
|
274
320
|
- `--commit` — Git commit SHA for traceability
|
|
275
321
|
- `--story` — Story or task ID
|
|
276
322
|
- `--files` — Comma-separated file paths touched by the decision
|
|
277
323
|
- `--relates-to` — Related repo names
|
|
278
324
|
- `--on-duplicate` — `consolidate` | `update` | `replace` | `create-new`
|
|
325
|
+
- `--bank <id>` — Bank id (default: `$MEMO_BANK`, `config.bank.default`, or `kb`)
|
|
326
|
+
- `--kind <kind>` — `self` | `episodic` | `semantic` (default: `episodic` in private banks, `semantic` in `kb`)
|
|
327
|
+
- `--session <id>` — Session id; **required** when `--kind episodic`
|
|
328
|
+
- `--seq <n>` — Explicit episodic sequence number (default: auto-incremented per session)
|
|
329
|
+
- `--context <ctx>` — Context tag; repeatable
|
|
330
|
+
- `--provenance <csv>` — Comma-separated UUIDs of source episodic entries; **required** for a `semantic` entry with `--source agent` unless `--manual` is passed (PRD K3)
|
|
331
|
+
- `--manual` — Force `source = manual`
|
|
332
|
+
- `--supersedes <id>` — Id of an existing entry this write supersedes (must share the same `bank` and `kind` as the target)
|
|
333
|
+
- `--pin` — Pin the entry (never auto-archived by decay)
|
|
334
|
+
- `--expires-in <duration>` — Episodic expiry override, e.g. `2d`, `12h`, `30m` (overrides the bank's default retention policy)
|
|
279
335
|
- `--json` — Machine-readable output (**always use in agent mode**)
|
|
280
336
|
|
|
281
337
|
**Duplicate handling:**
|
|
282
|
-
When memo detects a duplicate (same `repo + commit + story + entry_type + source`), interactive mode prompts for resolution. In `--json` mode you **MUST** supply `--on-duplicate` or the command will fail.
|
|
338
|
+
When memo detects a duplicate (same `repo + commit + story + entry_type + source`, or the equivalent v2 key including `bank`/`kind`/`session`/`seq`), interactive mode prompts for resolution. In `--json` mode you **MUST** supply `--on-duplicate` or the command will fail.
|
|
339
|
+
|
|
340
|
+
**Note:** `--confidence` is not a valid flag — confidence is inferred from `--source`.
|
|
283
341
|
|
|
284
342
|
---
|
|
285
343
|
|
|
@@ -295,11 +353,21 @@ Natural-language vector search over decision entries.
|
|
|
295
353
|
|
|
296
354
|
- `--scope` — `repo` (default) | `related`
|
|
297
355
|
- `--tags` — Comma-separated filter (AND logic)
|
|
298
|
-
- `--entry-type` —
|
|
299
|
-
- `--source` —
|
|
356
|
+
- `--entry-type` — Comma-separated types to include
|
|
357
|
+
- `--source` — Comma-separated sources to include
|
|
300
358
|
- `--limit` — Max results (default 10)
|
|
359
|
+
- `--lexical <on|off>` — Enable/disable lexical identifier matching (default `on`)
|
|
360
|
+
- `--explain` — Show a per-result factor breakdown
|
|
361
|
+
- `--bank <id>` — Bank id (default: `$MEMO_BANK`, `config.bank.default`, or `kb`)
|
|
362
|
+
- `--kind <kind>` — `self` | `episodic` | `semantic` | `all` (default `all`, case-insensitive)
|
|
363
|
+
- `--session <id>` — Restrict to an episodic session id
|
|
364
|
+
- `--include-archived` — Include archived entries
|
|
365
|
+
- `--include-superseded` — Include superseded entries
|
|
366
|
+
- `--as-of <iso>` — Point-in-time read (ISO 8601 date or datetime); implies `--include-superseded`
|
|
301
367
|
- `--json` — Machine-readable output
|
|
302
368
|
|
|
369
|
+
`--bank`, `--kind`, and `--session` isolate results the same way across `search`, `list`, `tags list`, and `read` — a query scoped to a private bank never returns `kb` results and vice versa, unless `--bank kb` is passed explicitly.
|
|
370
|
+
|
|
303
371
|
---
|
|
304
372
|
|
|
305
373
|
### `memo list` — Chronological Browse
|
|
@@ -315,8 +383,131 @@ Most-recent-first listing with optional date range.
|
|
|
315
383
|
- `--scope`, `--tags`, `--entry-type`, `--source` — Same as search
|
|
316
384
|
- `--from` / `--to` — ISO 8601 date boundaries
|
|
317
385
|
- `--limit` — Max results (default 20)
|
|
386
|
+
- `--bank`, `--kind`, `--session`, `--include-archived`, `--include-superseded`, `--as-of` — Same read-side flags as `search`
|
|
387
|
+
- `--json` — Machine-readable output
|
|
388
|
+
|
|
389
|
+
---
|
|
390
|
+
|
|
391
|
+
### `memo timeline` — Replay Episodic Memory
|
|
392
|
+
|
|
393
|
+
```bash
|
|
394
|
+
memo timeline --bank <agent>-memory --session ISSUE-42 --json
|
|
395
|
+
```
|
|
396
|
+
|
|
397
|
+
Replays episodic memory **in sequence order** — never ranked. Two shapes:
|
|
398
|
+
|
|
399
|
+
- With `--session <id>`: entries for that session, ordered by `seq` ascending (ties broken by `timestamp_utc` ascending).
|
|
400
|
+
- Without `--session`: recent episodic entries across the bank, newest-first, grouped by `session_id`; JSON shape is `{ sessions: [{ session_id, entries }] }`.
|
|
401
|
+
|
|
402
|
+
**Optional flags:**
|
|
403
|
+
|
|
404
|
+
- `--bank <id>` — Bank id (default: `$MEMO_BANK`, `config.bank.default`, or `kb`)
|
|
405
|
+
- `--session <id>` — Restrict to one episodic session
|
|
406
|
+
- `--last <n>` — Maximum number of entries (default 50, max 500 — values above 500 are clamped with a stderr warning)
|
|
407
|
+
- `--since <iso>` — Inclusive ISO 8601 lower bound for `timestamp_utc`
|
|
318
408
|
- `--json` — Machine-readable output
|
|
319
409
|
|
|
410
|
+
An empty bank returns exit `0` with `count: 0`. `timeline` never calls embeddings and never ranks — this is a raw sequence replay, unlike `search`.
|
|
411
|
+
|
|
412
|
+
---
|
|
413
|
+
|
|
414
|
+
### `memo bank` — Manage Memory Banks
|
|
415
|
+
|
|
416
|
+
```bash
|
|
417
|
+
memo bank list --json
|
|
418
|
+
memo bank show --id developer-memory --json
|
|
419
|
+
memo bank init --id developer-memory --set-default --json
|
|
420
|
+
```
|
|
421
|
+
|
|
422
|
+
Subcommands:
|
|
423
|
+
|
|
424
|
+
- **`bank init`** — Create a bank by writing its first `self` entry.
|
|
425
|
+
- `--id <id>` — Bank id (kebab-case or UUID; `kb` is rejected)
|
|
426
|
+
- `--rationale <text>` — Rationale for the self entry (default: `"Bank <id> initialised."`)
|
|
427
|
+
- `--tags <csv>` — 2–5 comma-separated tags (default: `bank,self`)
|
|
428
|
+
- `--set-default` — Set this bank as `config.bank.default` (writes `memo.config.json` unconditionally, every time the flag is passed)
|
|
429
|
+
- `--json` — Machine-readable output
|
|
430
|
+
- Idempotent: if the bank already has entries, `init` prints the existing summary and writes nothing.
|
|
431
|
+
- **`bank list`** — List every bank with counts per kind (`self`/`episodic`/`semantic`). `--json` for machine-readable output.
|
|
432
|
+
- **`bank show`** — Show one bank's `self` entries plus counts per kind **and per state** (`active`, `archived`, `superseded`), and `last_session_id`.
|
|
433
|
+
- `--id <id>` — Bank id (required)
|
|
434
|
+
- `--json` — Machine-readable output
|
|
435
|
+
|
|
436
|
+
`bank list`/`bank show` never accept `--orgs`/`--repos`/`--domains` — banks are an orthogonal axis to those facets, and private-bank entries may have no `repo`/`org` at all.
|
|
437
|
+
|
|
438
|
+
---
|
|
439
|
+
|
|
440
|
+
### `memo migrate --to-v2` — Migrate Legacy Payloads
|
|
441
|
+
|
|
442
|
+
```bash
|
|
443
|
+
memo migrate --to-v2 --dry-run --json
|
|
444
|
+
memo migrate --to-v2 --json
|
|
445
|
+
```
|
|
446
|
+
|
|
447
|
+
Migrates legacy v1 stored payloads to schema v2, idempotently (a point that already has `schema_version: '2'` is skipped on every run — the second real run always scans `0`). Nothing is archived, nothing is deleted, no vector is touched — this only rewrites payload fields (`bank = kb`, `schema_version = '2'`, `kind` per the matching rule, retention/counter defaults).
|
|
448
|
+
|
|
449
|
+
**Flags:**
|
|
450
|
+
|
|
451
|
+
- `--to-v2` — Target schema version; currently the only supported target (**required**)
|
|
452
|
+
- `--dry-run` — Plan only; writes nothing; exits `0`; prints counts
|
|
453
|
+
- `--rules <file>` — JSON file replacing the default rule set (see below)
|
|
454
|
+
- `--json` — Machine-readable output; without it, progress prints to stderr
|
|
455
|
+
|
|
456
|
+
**Migration guidance — always dry-run first:**
|
|
457
|
+
|
|
458
|
+
1. Run `memo migrate --to-v2 --dry-run --json` and review the `byRule` counts and `skipped` total before doing anything else.
|
|
459
|
+
2. Only run the real migration (`memo migrate --to-v2 --json`, no `--dry-run`) against your own local/dev Qdrant instance — **never** against a shared or production collection without a separate, explicit human-confirmed step. This is a `developer`-workstation operation, not something to run unattended in CI or against `infra-engineer`-owned infrastructure.
|
|
460
|
+
3. Re-run `--dry-run` afterward to confirm `scanned: 0` — that's the idempotency check.
|
|
461
|
+
|
|
462
|
+
**Custom `--rules` file** (optional, replaces the default FR-2.8 rule set):
|
|
463
|
+
|
|
464
|
+
```json
|
|
465
|
+
[
|
|
466
|
+
{
|
|
467
|
+
"name": "1",
|
|
468
|
+
"when": { "tags_any": ["intent", "outcome"] },
|
|
469
|
+
"set": { "kind": "episodic", "session_from": "story", "expires_in_days": 90 }
|
|
470
|
+
},
|
|
471
|
+
{ "name": "2", "when": {}, "set": { "kind": "semantic" } }
|
|
472
|
+
]
|
|
473
|
+
```
|
|
474
|
+
|
|
475
|
+
`when` supports `tags_any`, `tags_all`, `entry_type_in`, `source_in`, `repo_in`; `set.kind` is required (any of `self`/`episodic`/`semantic`); `session_from` (`story | legacy`) and `expires_in_days` apply only to `episodic` rules. Rules are evaluated in order, first match wins. A rules file that leaves any point unmatched fails validation up front (`VALIDATION_FAILED`, "rule set is not exhaustive: add a final rule with empty `when`") — always end your custom rule set with a catch-all `{ "when": {} }` entry.
|
|
476
|
+
|
|
477
|
+
---
|
|
478
|
+
|
|
479
|
+
### `memo recall` — One-Call Context Restore
|
|
480
|
+
|
|
481
|
+
```bash
|
|
482
|
+
memo recall "<task description>" --bank <agent>-memory --json
|
|
483
|
+
```
|
|
484
|
+
|
|
485
|
+
The 1.3.0 replacement for the four-command session-start sequence (`list` + `tags list` + `search` + `search --scope related`). Gathers, in one call (≤ 4 s target):
|
|
486
|
+
|
|
487
|
+
| Section | Content | Omitted when |
|
|
488
|
+
| -------------- | --------------------------------------------------------------------- | --------------------------------------------------- |
|
|
489
|
+
| `SELF` | This agent's own persona/context entries, newest first, never trimmed | `--bank` resolves to `kb` |
|
|
490
|
+
| `POLICIES` | Ranked semantic policy entries from `kb` | never (empty until later phases add policy entries) |
|
|
491
|
+
| `SHARED` | Ranked semantic entries from `kb`, scoped by `--scope` | never |
|
|
492
|
+
| `MINE` | Ranked semantic entries from this agent's own bank | `--bank` resolves to `kb` |
|
|
493
|
+
| `LAST SESSION` | The most recent episodic session's entries, in `seq` order | `--bank` resolves to `kb` |
|
|
494
|
+
| `CONFLICTS` | Pending-contradiction entries (empty until a later phase) | never |
|
|
495
|
+
|
|
496
|
+
**Flags:**
|
|
497
|
+
|
|
498
|
+
- `--bank <id>` — Bank id (default: `$MEMO_BANK`, `config.bank.default`, or `kb`)
|
|
499
|
+
- `--scope <scope>` — `repo` | `related`, applies to `SHARED` only (default: config or `repo`)
|
|
500
|
+
- `--max-tokens <n>` — Token budget (default: `config.recall.max_tokens`, `2000`)
|
|
501
|
+
- `--json` — Machine-readable output
|
|
502
|
+
|
|
503
|
+
When the budget is tight, sections are trimmed in this order: `conflicts` → `last_session` (oldest entries first) → `mine` → `shared` → `policies`. `SELF` is **never** trimmed, even if it alone exceeds the budget — in that case `truncated` lists every other section and the response honestly reports `budget.used_tokens > max_tokens` rather than silently cutting `SELF`. `recall` performs zero writes.
|
|
504
|
+
|
|
505
|
+
**On failure:** `memo recall` exits `2` on an embeddings failure (`EMBEDDING_API_ERROR`) or a mid-gather Qdrant failure (`QDRANT_OPERATION_FAILED`) — there is no partial-bundle fallback. Treat this the same as any other exit-`2` failure: surface the warning, and continue the session without recalled context rather than blocking on it.
|
|
506
|
+
|
|
507
|
+
**When no private bank is passed** (resolves to `kb`): `SELF`, `MINE`, and `LAST SESSION` are omitted from the response entirely (omitted keys, not empty arrays) — you still get `POLICIES`, `SHARED`, `CONFLICTS`.
|
|
508
|
+
|
|
509
|
+
**Fallback when `memo recall` is unavailable** (`memo --version` below `1.3.0`, or the command errors as unrecognized): fall back to the four-command sequence documented under **Session Start — Restore Context** in `SKILL.md`.
|
|
510
|
+
|
|
320
511
|
---
|
|
321
512
|
|
|
322
513
|
### `memo tags list` — Discover Tags
|
|
@@ -373,7 +564,17 @@ Exactly one of `--id`, `--all-by-repo`, or `--all-by-org` is required.
|
|
|
373
564
|
|
|
374
565
|
### Starting a Session — Restore Context
|
|
375
566
|
|
|
376
|
-
|
|
567
|
+
**memo-cli 1.3.0+ (preferred):** confirm config, then restore the full context bundle in one call:
|
|
568
|
+
|
|
569
|
+
```bash
|
|
570
|
+
# 1. Confirm config is valid
|
|
571
|
+
memo setup validate
|
|
572
|
+
|
|
573
|
+
# 2. Restore SELF, POLICIES, SHARED, MINE, LAST SESSION, CONFLICTS in one bundle
|
|
574
|
+
memo recall "<current task or feature description>" --bank <agent>-memory --json
|
|
575
|
+
```
|
|
576
|
+
|
|
577
|
+
**Fallback (`memo --version` below `1.3.0`):** run this sequence instead, before writing a single line of code:
|
|
377
578
|
|
|
378
579
|
```bash
|
|
379
580
|
# 1. Confirm config is valid
|
|
@@ -392,7 +593,11 @@ memo tags list --sort frequency --json
|
|
|
392
593
|
memo search "<current task or feature description>" --limit 10 --json
|
|
393
594
|
```
|
|
394
595
|
|
|
395
|
-
Read the results before proceeding. Prior entries may contain constraints, preferred patterns, or rejected alternatives that directly affect how you should approach the current task.
|
|
596
|
+
Read the results before proceeding, whichever path was used. Prior entries may contain constraints, preferred patterns, or rejected alternatives that directly affect how you should approach the current task. If `memo recall` exits `2` (embeddings failure), surface the warning and continue the session without recalled context.
|
|
597
|
+
|
|
598
|
+
### Ending a Session — No Memo Action in Phase 2
|
|
599
|
+
|
|
600
|
+
Phase 2 has no session-close memo step. `memo used` (marking which recalled entries were actually useful) and `memo decay` (retention scoring) arrive with memo-cli 1.4.0 — do not invent a workaround for either in the meantime.
|
|
396
601
|
|
|
397
602
|
---
|
|
398
603
|
|
|
@@ -759,16 +964,24 @@ When a command fails:
|
|
|
759
964
|
## Quick Reference Card
|
|
760
965
|
|
|
761
966
|
```
|
|
762
|
-
memo setup init --repo <r> --org <o> --domain <d>
|
|
763
|
-
memo setup validate
|
|
764
|
-
memo setup show [--json]
|
|
765
|
-
|
|
766
|
-
memo
|
|
767
|
-
memo
|
|
768
|
-
memo
|
|
769
|
-
memo
|
|
770
|
-
memo
|
|
771
|
-
memo
|
|
967
|
+
memo setup init --repo <r> --org <o> --domain <d> # Initialize config
|
|
968
|
+
memo setup validate # Verify config
|
|
969
|
+
memo setup show [--json] # Display config
|
|
970
|
+
|
|
971
|
+
memo recall "<task>" --bank <agent>-memory [--json] # Restore full context (1.3.0+)
|
|
972
|
+
memo write --rationale "..." --tags "a,b,c" [--json] # Record a semantic decision (kb)
|
|
973
|
+
memo write --kind episodic --session ID --bank <agent>-memory [--json] # Record an intent/outcome entry
|
|
974
|
+
memo search "query" [--scope related] [--bank ID] [--kind K] [--json] # Semantic search
|
|
975
|
+
memo list [--from DATE] [--to DATE] [--bank ID] [--kind K] [--json] # Browse entries
|
|
976
|
+
memo timeline [--session ID] --bank <agent>-memory [--last N] [--json] # Replay episodic memory in order
|
|
977
|
+
memo tags list [--sort frequency] [--json] # Discover tags
|
|
978
|
+
memo inspect [--json] # Global facets
|
|
979
|
+
memo bank list [--json] # List all banks
|
|
980
|
+
memo bank show --id <id> [--json] # Show one bank's self entries + counts
|
|
981
|
+
memo bank init --id <id> [--set-default] [--json] # Create a bank
|
|
982
|
+
memo migrate --to-v2 --dry-run [--json] # Preview legacy payload migration
|
|
983
|
+
memo migrate --to-v2 [--json] # Apply legacy payload migration (local/dev only)
|
|
984
|
+
memo delete --id <uuid> [--json] # Delete entry
|
|
772
985
|
```
|
|
773
986
|
|
|
774
987
|
---
|
|
@@ -19,9 +19,39 @@ If validation fails, run: `memo setup init --repo <repo> --org <org> --domain <d
|
|
|
19
19
|
|
|
20
20
|
---
|
|
21
21
|
|
|
22
|
+
## Banks and Kinds (memo-cli 1.3.0+)
|
|
23
|
+
|
|
24
|
+
A **bank** is a namespace an agent's entries live in — the shared `kb` (default, semantic knowledge base) or a private bank like `developer-memory`, one per long-lived agent. Set `--bank <id>` on any command.
|
|
25
|
+
|
|
26
|
+
**Agents: always pass `--bank <id>` literally on every command.** Agent runtimes run each shell command in a fresh shell, so an `export MEMO_BANK=…` from an earlier command is gone by the next one. An unquoted empty `$MEMO_BANK` is dropped by the shell, and the flag parser then reads the next token as the bank id (`--bank --rationale …` → bank `--rationale`), which memo-cli rejects with `VALIDATION_FAILED` (dev-tasks issue #253). Never write `--bank $MEMO_BANK` in an agent prompt or command.
|
|
27
|
+
|
|
28
|
+
```bash
|
|
29
|
+
memo write --bank developer-memory ... # bank id convention: <agent-name>-memory
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
Every entry has a **kind**:
|
|
33
|
+
|
|
34
|
+
| Kind | Meaning | Default bank behavior |
|
|
35
|
+
| ---------- | ----------------------------------------------------------------- | -------------------------------------------------------- |
|
|
36
|
+
| `self` | The agent's own persona/context, never trimmed from `recall` | `kb` rejects `self`; only valid in private banks |
|
|
37
|
+
| `episodic` | Session-scoped narration (intent/outcome), expires automatically | requires `--session <id>`; default kind in private banks |
|
|
38
|
+
| `semantic` | Durable, searchable decisions — what `search`/`list` return today | default kind in `kb` |
|
|
39
|
+
|
|
40
|
+
Rule of thumb: episodic entries are per-session chatter that lives in your private bank and expires; semantic entries are durable knowledge that lives in `kb` (or is promoted there later) and never expires. See [`REFERENCE.md`](./REFERENCE.md) for bank/kind command reference, `memo recall`, `memo timeline`, `memo bank`, and `memo migrate`.
|
|
41
|
+
|
|
42
|
+
---
|
|
43
|
+
|
|
22
44
|
## Session Start — Restore Context
|
|
23
45
|
|
|
24
|
-
|
|
46
|
+
**memo-cli 1.3.0+:** one call restores the full context bundle (SELF, POLICIES, SHARED, MINE, LAST SESSION, CONFLICTS):
|
|
47
|
+
|
|
48
|
+
```bash
|
|
49
|
+
memo recall "<current task description>" --bank <agent>-memory --json
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
If no bank is passed (and `MEMO_BANK` is unset), `recall` resolves to `kb` and omits the private-only sections (`SELF`, `MINE`, `LAST SESSION`).
|
|
53
|
+
|
|
54
|
+
**Fallback (`memo --version` < 1.3.0, or `memo recall` unavailable):** run the four-command sequence instead:
|
|
25
55
|
|
|
26
56
|
```bash
|
|
27
57
|
memo list --limit 20 --json
|
|
@@ -30,7 +60,7 @@ memo search "<current task description>" --limit 10 --json
|
|
|
30
60
|
memo search "<key contract or dependency>" --scope related --limit 5 --json
|
|
31
61
|
```
|
|
32
62
|
|
|
33
|
-
Synthesize findings into:
|
|
63
|
+
Synthesize findings (either path) into:
|
|
34
64
|
|
|
35
65
|
- Constraints to preserve
|
|
36
66
|
- Rejected alternatives to avoid
|
|
@@ -41,10 +71,13 @@ Synthesize findings into:
|
|
|
41
71
|
|
|
42
72
|
## Writing Entries
|
|
43
73
|
|
|
44
|
-
### Intent Entry (before starting a story/task)
|
|
74
|
+
### Intent Entry (before starting a story/task) — episodic, in your bank
|
|
45
75
|
|
|
46
76
|
```bash
|
|
47
77
|
memo write \
|
|
78
|
+
--kind episodic \
|
|
79
|
+
--session ISSUE-<number> \
|
|
80
|
+
--bank <agent>-memory \
|
|
48
81
|
--rationale "Context: Starting ISSUE-<##> because <trigger>. Decision: implement via <approach>, preserving <constraints>. Impact: affects <modules/contracts>." \
|
|
49
82
|
--tags "<domain>,issue-<number>,intent,<impact-tag>" \
|
|
50
83
|
--entry-type decision \
|
|
@@ -54,10 +87,13 @@ memo write \
|
|
|
54
87
|
--json
|
|
55
88
|
```
|
|
56
89
|
|
|
57
|
-
### Outcome Entry (after completing a story/task)
|
|
90
|
+
### Outcome Entry (after completing a story/task) — episodic, in your bank
|
|
58
91
|
|
|
59
92
|
```bash
|
|
60
93
|
memo write \
|
|
94
|
+
--kind episodic \
|
|
95
|
+
--session ISSUE-<number> \
|
|
96
|
+
--bank <agent>-memory \
|
|
61
97
|
--rationale "Context: Completed ISSUE-<##>. Delivery: shipped <behavior>, deviations <none|details>, AC <x/y> verified. Impact: quality gates test=<p/f>; lint=<p/f>; format:check=<p/f>; typecheck=<p/f>; audit=<p/f>." \
|
|
62
98
|
--tags "<domain>,issue-<number>,outcome,gates-pass" \
|
|
63
99
|
--entry-type decision \
|
|
@@ -69,17 +105,24 @@ memo write \
|
|
|
69
105
|
--json
|
|
70
106
|
```
|
|
71
107
|
|
|
72
|
-
|
|
108
|
+
`--session` is required whenever `--kind episodic` is used; `--seq` auto-increments per session and rarely needs to be passed explicitly.
|
|
109
|
+
|
|
110
|
+
### Decision/ADR Entry (architectural choices) — semantic, in `kb`
|
|
73
111
|
|
|
74
112
|
```bash
|
|
75
113
|
memo write \
|
|
114
|
+
--kind semantic \
|
|
115
|
+
--bank kb \
|
|
76
116
|
--rationale "Context: <situation>. Decision: <what was chosen>. Rationale: <why this over alternatives>." \
|
|
77
117
|
--tags "<domain>,<technology>,decision" \
|
|
78
118
|
--entry-type decision \
|
|
79
119
|
--source agent \
|
|
120
|
+
--provenance "<csv of episodic entry ids this consolidates, if any>" \
|
|
80
121
|
--json
|
|
81
122
|
```
|
|
82
123
|
|
|
124
|
+
A `semantic` entry with `--source agent` **MUST** carry `--provenance <csv>` unless `--manual` is passed (PRD K3) — cite the episodic intent/outcome ids the decision was distilled from.
|
|
125
|
+
|
|
83
126
|
---
|
|
84
127
|
|
|
85
128
|
## Entry Types
|
|
@@ -129,16 +172,28 @@ memo write \
|
|
|
129
172
|
|
|
130
173
|
---
|
|
131
174
|
|
|
175
|
+
## Session Close
|
|
176
|
+
|
|
177
|
+
No memo action in Phase 2. `memo used` and `memo decay` arrive with memo-cli 1.4.0.
|
|
178
|
+
|
|
179
|
+
---
|
|
180
|
+
|
|
132
181
|
## Quick Command Card
|
|
133
182
|
|
|
134
183
|
```
|
|
135
|
-
memo setup validate
|
|
136
|
-
memo
|
|
137
|
-
memo
|
|
138
|
-
memo
|
|
139
|
-
memo
|
|
140
|
-
memo
|
|
141
|
-
memo
|
|
184
|
+
memo setup validate # Verify config
|
|
185
|
+
memo recall "<task>" --bank <agent>-memory --json # Restore full context (1.3.0+)
|
|
186
|
+
memo write --rationale "..." --tags "a,b,c" --json # Record a semantic decision (kb)
|
|
187
|
+
memo write --kind episodic --session ID --bank <agent>-memory # Record an intent/outcome entry
|
|
188
|
+
memo search "query" [--scope related] --json # Semantic search
|
|
189
|
+
memo list [--limit N] --json # Browse recent
|
|
190
|
+
memo timeline [--session ID] --bank <agent>-memory --json # Replay episodic memory in order
|
|
191
|
+
memo tags list [--sort frequency] --json # Discover tags
|
|
192
|
+
memo inspect --json # Global facets
|
|
193
|
+
memo bank list --json # List all banks
|
|
194
|
+
memo bank init --id <id> --json # Create a bank
|
|
195
|
+
memo migrate --to-v2 --dry-run --json # Preview legacy payload migration
|
|
196
|
+
memo delete --id <uuid> --json # Delete entry
|
|
142
197
|
```
|
|
143
198
|
|
|
144
|
-
> For full flag documentation, admin operations, environment setup, and detailed examples, read [`REFERENCE.md`](./REFERENCE.md).
|
|
199
|
+
> For full flag documentation, admin operations, environment setup, banks/kinds, `recall`, `timeline`, `bank`, `migrate`, and detailed examples, read [`REFERENCE.md`](./REFERENCE.md).
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
# Supabase Operations (supabase-ops)
|
|
2
|
+
|
|
3
|
+
Per-surface mechanism skill for `infra-engineer`. It supplies the Supabase CLI command sets, resource tiers, the `db diff` migration flow, the drift rule, backup and revert sources, inventory findings, and the Supabase Cloud log table. It does not restate the agent's working loop, approval, revert, or backup rules — those live in the agent body. Supabase is the one platform with a genuine plan mechanism (`db diff`), and its keys are the highest-value secrets in the stack.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
> **RFC 2119 Notice:** The key words **MUST**, **MUST NOT**, **REQUIRED**, **SHALL**, **SHALL NOT**, **SHOULD**, **SHOULD NOT**, **RECOMMENDED**, **MAY**, and **OPTIONAL** in this document are to be interpreted as described in [RFC 2119](https://www.rfc-editor.org/rfc/rfc2119).
|
|
8
|
+
|
|
9
|
+
## Tool declaration
|
|
10
|
+
|
|
11
|
+
| Field | Value |
|
|
12
|
+
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
13
|
+
| `name` | `supabase` |
|
|
14
|
+
| `probe` | `supabase --version` (expects `2.x`) |
|
|
15
|
+
| `floor` | Supabase CLI `2.x`; minimum `2.11`. A `1.x` install is `below-floor`. |
|
|
16
|
+
| `auth_probe` | `supabase projects list` |
|
|
17
|
+
| `remediation` | "Install Supabase CLI v2 and run `supabase login` (or export `SUPABASE_ACCESS_TOKEN`); link the project with `supabase link --project-ref <ref>`. This skill never auto-installs and offers no fallback." |
|
|
18
|
+
|
|
19
|
+
Identity is asserted by comparing the linked project ref (from `supabase projects list` / the linked `project_ref`) with the target environment's `supabase.project_ref`; a mismatch is `wrong-identity` and blocks.
|
|
20
|
+
|
|
21
|
+
## Resource tiers
|
|
22
|
+
|
|
23
|
+
| Tier | Supabase resources |
|
|
24
|
+
| --------------- | ------------------------------------------------------------------------------------- |
|
|
25
|
+
| **foundation** | project, plan, compute add-on, read replicas, PITR |
|
|
26
|
+
| **application** | schema, migrations, RLS policies, roles, storage buckets, auth config, Edge Functions |
|
|
27
|
+
| **ephemeral** | preview branches, which carry an `ExpiresAt` tag and a cleanup step |
|
|
28
|
+
|
|
29
|
+
Foundation changes are routed to `tier0_tool`, never written by this agent. Project deletion is refused for a production-mapped project.
|
|
30
|
+
|
|
31
|
+
## Migration flow (db diff as plan)
|
|
32
|
+
|
|
33
|
+
1. `supabase db diff -f "$NAME"` produces the migration SQL — this **is** the plan. Do not push before it is reviewed.
|
|
34
|
+
2. **Destructive statements** (`DROP`, `TRUNCATE`, `ALTER ... DROP COLUMN`, type narrowing) are itemized separately in `plan.md`, each as its own line requiring named approval.
|
|
35
|
+
3. Confirmation is required before `supabase db push` to any shared or production project. The push runs only after the human approves that step.
|
|
36
|
+
4. Verification: `supabase migration list` shows the new migration applied on the remote.
|
|
37
|
+
5. **Drift rule:** a non-empty `supabase db diff` against the remote with **no pending local migration** is reported as drift and **never pushed**. Drift is reported, never reconciled by pushing. The agent records the drift in `result.md` and stops.
|
|
38
|
+
|
|
39
|
+
```sh
|
|
40
|
+
supabase db diff -f add_orders_table # plan
|
|
41
|
+
# review the generated migration; itemize destructive statements
|
|
42
|
+
supabase db push # apply, only after confirmation
|
|
43
|
+
supabase migration list # verify
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
## Backup
|
|
47
|
+
|
|
48
|
+
Before any production step touching schema or data, record a backup: `supabase db dump -f backup.sql --data-only` (and a schema dump) **or** a recorded PITR restore point when PITR is enabled on the project. The backup artifact reference and the restore command are recorded in `result.md` before the step applies. Revert of a schema change is a forward migration that reverses it, applied through the same confirmed flow; there is no silent `db reset` against a shared project.
|
|
49
|
+
|
|
50
|
+
## Discovery order
|
|
51
|
+
|
|
52
|
+
Discovery prefers **Supabase MCP read-only** when present, then the **CLI**, then the **Management API**, and records which path was used in the inventory `_generated` block. Writes never go through MCP — MCP is read-only for discovery only. No MCP write, ever.
|
|
53
|
+
|
|
54
|
+
## Inventory and findings
|
|
55
|
+
|
|
56
|
+
Inventory files under `infra/inventory/supabase/<ref>.json` carry the standard `_generated` header and these fields:
|
|
57
|
+
|
|
58
|
+
- `has_legacy_keys: bool` — reported as a finding when legacy (pre-publishable/secret) keys are still in use.
|
|
59
|
+
- `rls_disabled_tables: []` — tables with row-level security disabled, reported as findings.
|
|
60
|
+
|
|
61
|
+
Inventory contains **no key material**, masked or otherwise. Reporting `has_legacy_keys` or `rls_disabled_tables` never includes the key or a sample row.
|
|
62
|
+
|
|
63
|
+
## Secrets
|
|
64
|
+
|
|
65
|
+
- Edge Function secrets are set with `supabase secrets set KEY=value` / `supabase secrets unset KEY`, from the source of truth, never a transcript.
|
|
66
|
+
- **Publishable versus secret keys** are distinguished at every reference: a `sb_publishable_*` key is client-safe; a `sb_secret_*` key and the `service_role` JWT are server-only and never leave a secret store.
|
|
67
|
+
- No AWS Secrets Manager entry for a Supabase-only workload; Supabase secrets stay on Supabase.
|
|
68
|
+
|
|
69
|
+
## Supabase Cloud log table
|
|
70
|
+
|
|
71
|
+
Retrieval, retention, and query bounds are grounded in `workstream/research-supabase-logs.md` (researcher pass, 2025-09-12). Key facts cited from that artifact:
|
|
72
|
+
|
|
73
|
+
- **The Supabase CLI has no log command on Cloud.** The scriptable path is the Management API logs endpoint `GET /v1/projects/{ref}/analytics/endpoints/logs`, which runs a ClickHouse-dialect SQL/LQL query over a unified logs stream filtered by a `source` column; the Dashboard Logs Explorer is the interactive equivalent. `supabase inspect db ...` is Postgres diagnostics, not service logs.
|
|
74
|
+
- **Time bounds are mandatory in practice:** the endpoint uses `iso_timestamp_start` / `iso_timestamp_end`, the window MUST be ≤ 24 hours, and an omitted range queries only the last minute — so every triage query states an explicit UTC window before it runs.
|
|
75
|
+
|
|
76
|
+
| Service surface | Source selector / collection | Retrieval path |
|
|
77
|
+
| --------------- | ------------------------------------------------------------- | --------------------------------------- |
|
|
78
|
+
| Postgres | `source = postgres_logs` | Management API logs endpoint; Dashboard |
|
|
79
|
+
| API (PostgREST) | API Gateway collection | Management API logs endpoint; Dashboard |
|
|
80
|
+
| Auth (GoTrue) | Auth collection | Management API logs endpoint; Dashboard |
|
|
81
|
+
| Storage | Storage collection | Management API logs endpoint; Dashboard |
|
|
82
|
+
| Realtime | Realtime collection | Management API logs endpoint; Dashboard |
|
|
83
|
+
| Edge Functions | `source = edge_logs` / `function_edge_logs` / `function_logs` | Management API logs endpoint; Dashboard |
|
|
84
|
+
|
|
85
|
+
**Retention caveat (cite the research artifact, re-confirm at citation time):** built-in log retention is short and plan-gated — Free ≈ 1 day, Pro ≈ 7 days, Team ≈ 28 days, Enterprise ≈ 90 days. Because low-tier retention is short, logs MUST be captured at incident time; Log Drains (Team/Enterprise) is the long-retention path. Exact `source` strings for API/Auth/Storage/Realtime are UNCONFIRMED in the research and must be verified from the Logs Explorer source list before hardcoding. All log output passes through the redaction pattern set before it reaches a transcript or file.
|
|
86
|
+
|
|
87
|
+
## Cost entries and sweep
|
|
88
|
+
|
|
89
|
+
Cost entries listed on every Supabase plan:
|
|
90
|
+
|
|
91
|
+
- **Plan** tier (Free/Pro/Team/Enterprise) base.
|
|
92
|
+
- **Compute** add-on size.
|
|
93
|
+
- **Read replicas**.
|
|
94
|
+
- **PITR** add-on.
|
|
95
|
+
- **Preview branches**.
|
|
96
|
+
- **Egress**.
|
|
97
|
+
|
|
98
|
+
Sweep categories (read-only, reported never remediated):
|
|
99
|
+
|
|
100
|
+
- Preview branches past their `ExpiresAt` tag.
|
|
101
|
+
- Preview branches without any `ExpiresAt` tag.
|
|
102
|
+
- Paid but idle projects.
|
|
103
|
+
- Read replicas with no traffic.
|
|
104
|
+
- PITR enabled on a non-production project.
|