@entelligentsia/forgecli 0.1.0 → 0.2.0

package/dist/forge-payload/.base-pack/commands/run-task.md

@@ -0,0 +1,22 @@
+---
+name: run-task
+description: Orchestrate the full plan→implement→review→approve pipeline for a task
+---
+
+# /{{PREFIX}}:run-task
+
+Read the run-task workflow and follow it.
+
+## Locate the Forge plugin
+
+```
+FORGE_ROOT: !`echo "${CLAUDE_PLUGIN_ROOT}"`
+```
+
+## Execute
+
+Read `.forge/workflows/orchestrate_task.md` and follow it.
+
+## Arguments
+
+$ARGUMENTS

package/dist/forge-payload/.base-pack/commands/sprint-intake.md

@@ -0,0 +1,22 @@
+---
+name: sprint-intake
+description: Elicit and structure requirements for a new sprint
+---
+
+# /{{PREFIX}}:sprint-intake
+
+Read the sprint-intake workflow and follow it.
+
+## Locate the Forge plugin
+
+```
+FORGE_ROOT: !`echo "${CLAUDE_PLUGIN_ROOT}"`
+```
+
+## Execute
+
+Read `.forge/workflows/architect_sprint_intake.md` and follow it.
+
+## Arguments
+
+$ARGUMENTS

package/dist/forge-payload/.base-pack/commands/sprint-plan.md

@@ -0,0 +1,22 @@
+---
+name: sprint-plan
+description: Decompose sprint requirements into tasks with dependencies
+---
+
+# /{{PREFIX}}:sprint-plan
+
+Read the sprint-plan workflow and follow it.
+
+## Locate the Forge plugin
+
+```
+FORGE_ROOT: !`echo "${CLAUDE_PLUGIN_ROOT}"`
+```
+
+## Execute
+
+Read `.forge/workflows/architect_sprint_plan.md` and follow it.
+
+## Arguments
+
+$ARGUMENTS

package/dist/forge-payload/.base-pack/commands/validate.md

@@ -0,0 +1,22 @@
+---
+name: validate
+description: Validate that a task implementation satisfies acceptance criteria
+---
+
+# /{{PREFIX}}:validate
+
+Read the validate workflow and follow it.
+
+## Locate the Forge plugin
+
+```
+FORGE_ROOT: !`echo "${CLAUDE_PLUGIN_ROOT}"`
+```
+
+## Execute
+
+Read `.forge/workflows/validate_task.md` and follow it.
+
+## Arguments
+
+$ARGUMENTS

package/dist/forge-payload/.claude-plugin/plugin.json

@@ -0,0 +1,15 @@
+{
+  "name": "forge",
+  "version": "0.40.3",
+  "description": "Self-enhancing AI software development lifecycle — generates project-specific SDLC instances from meta-definitions",
+  "license": "MIT",
+  "author": {
+    "name": "Entelligentsia",
+    "email": "hello@entelligentsia.in",
+    "url": "https://github.com/Entelligentsia"
+  },
+  "repository": "https://github.com/Entelligentsia/forge",
+  "updateUrl": "https://raw.githubusercontent.com/Entelligentsia/forge/release/forge/.claude-plugin/plugin.json",
+  "migrationsUrl": "https://raw.githubusercontent.com/Entelligentsia/forge/release/forge/migrations.json",
+  "keywords": ["sdlc", "ai-agents", "code-review", "sprint-planning", "meta-generator"]
+}

package/dist/forge-payload/.init/discovery/discover-database.md

@@ -0,0 +1,32 @@
+# Discovery: Database
+
+## Purpose
+
+Detect the project's data model: entities, relationships, field types,
+and migration patterns.
+
+## Scan Targets
+
+| Pattern | What It Reveals |
+|---------|----------------|
+| Django: `models.py` files | ORM models, fields, relationships |
+| Rails: `app/models/*.rb` | ActiveRecord models |
+| Prisma: `schema.prisma` | Prisma schema |
+| TypeORM: `*.entity.ts` | TypeORM entities |
+| Sequelize: `models/*.js` | Sequelize models |
+| Go: `*_model.go` | Go struct definitions |
+| SQL: `migrations/` / `schema.sql` | Raw schema |
+| MongoDB: Mongoose schemas | Document models |
+
+## Tools
+
+Use Grep to find model/entity definitions, Read to parse them.
+
+## Output
+
+Structured report:
+- Entity inventory (name, field count, key relationships)
+- Database type (PostgreSQL, MySQL, MongoDB, SQLite, etc.)
+- ORM/query layer in use
+- Migration framework and directory
+- Seed data presence

package/dist/forge-payload/.init/discovery/discover-processes.md

@@ -0,0 +1,31 @@
+# Discovery: Processes
+
+## Purpose
+
+Detect the project's service topology, build tools, and deployment configuration.
+
+## Scan Targets
+
+| File | What It Reveals |
+|------|----------------|
+| `docker-compose.yml` | Service topology, dependencies, ports |
+| `Procfile` | Process types (web, worker, etc.) |
+| `ecosystem.config.js` | PM2 process management |
+| `systemd/*.service` | System service definitions |
+| `.github/workflows/*.yml` | CI/CD pipeline |
+| `.gitlab-ci.yml` | CI/CD pipeline |
+| `Jenkinsfile` | CI/CD pipeline |
+| `vercel.json` / `netlify.toml` | Deployment platform |
+
+## Tools
+
+Use Glob to find these files, Read to parse them.
+
+## Output
+
+Structured report:
+- Services and their roles (web, worker, database, cache, etc.)
+- Build command(s)
+- Deploy command(s) or platform
+- CI/CD pipeline structure
+- Environment variables referenced (names only, not values)

package/dist/forge-payload/.init/discovery/discover-routing.md

@@ -0,0 +1,31 @@
+# Discovery: Routing
+
+## Purpose
+
+Detect the project's API surface, authentication strategy, and middleware.
+
+## Scan Targets
+
+| Pattern | What It Reveals |
+|---------|----------------|
+| Django: `urls.py`, `views.py` | URL patterns, view functions/classes |
+| Express: `router.get/post/...` | Route definitions |
+| Rails: `routes.rb` | Route definitions |
+| FastAPI: `@app.get/post` | Endpoint decorators |
+| Go: `http.HandleFunc` / mux | Route handlers |
+| Auth decorators/middleware | `@login_required`, `authenticate`, `IsAuthenticated` |
+| API docs: `openapi.yaml` / `swagger.json` | API specification |
+
+## Tools
+
+Use Grep to find route definitions and auth patterns, Read to parse them.
+
+## Output
+
+Structured report:
+- Route count (approximate)
+- Auth strategy (decorator-based, middleware, JWT, session, etc.)
+- Public vs protected route ratio
+- URL namespace structure
+- API versioning (if any)
+- Middleware chain

package/dist/forge-payload/.init/discovery/discover-stack.md

@@ -0,0 +1,33 @@
+# Discovery: Stack
+
+## Purpose
+
+Detect the project's programming languages, frameworks, versions, and runtime.
+
+## Scan Targets
+
+| File | What It Reveals |
+|------|----------------|
+| `package.json` | Node.js, npm dependencies, scripts |
+| `requirements.txt` / `Pipfile` / `pyproject.toml` | Python, pip dependencies |
+| `go.mod` | Go, module dependencies |
+| `Cargo.toml` | Rust, crate dependencies |
+| `Gemfile` | Ruby, gem dependencies |
+| `Dockerfile` | Runtime, base image, build steps |
+| `Makefile` | Build commands, task aliases |
+| `*.sln` / `*.csproj` | .NET, C# |
+
+## Tools
+
+Use Glob to find these files, Read to parse them.
+
+## Output
+
+Structured report:
+- Primary language(s)
+- Framework(s) with versions
+- Frontend framework (if any)
+- Database (if detectable from dependencies)
+- Task queue (if any)
+- Containerisation (if any)
+- Runtime version constraints

package/dist/forge-payload/.init/discovery/discover-testing.md

@@ -0,0 +1,34 @@
+# Discovery: Testing
+
+## Purpose
+
+Detect the project's test framework, test commands, build commands,
+and lint configuration.
+
+## Scan Targets
+
+| Pattern | What It Reveals |
+|---------|----------------|
+| `test/` / `tests/` / `__tests__/` / `*_test.go` | Test directory structure |
+| `jest.config.*` / `vitest.config.*` | JS test framework config |
+| `pytest.ini` / `setup.cfg` / `pyproject.toml [tool.pytest]` | Python test config |
+| `package.json scripts.test` | Test command |
+| `.eslintrc*` / `ruff.toml` / `.golangci.yml` | Lint configuration |
+| `.github/workflows/*.yml` | CI test/build/lint commands |
+| `coverage/` / `.coveragerc` / `lcov.info` | Coverage configuration |
+
+## Tools
+
+Use Glob to find config files, Read to parse them. Use Bash to verify
+commands work (e.g., `npm test --help` or `pytest --co -q | head`).
+
+## Output
+
+Structured report:
+- Test framework(s) and version
+- Test command (exact command to run tests)
+- Build command (exact command to build)
+- Lint command (exact command to lint)
+- Syntax check command per language
+- Coverage tooling (if any)
+- Approximate test count

package/dist/forge-payload/.init/generation/generate-kb-doc.md

@@ -0,0 +1,60 @@
+# Knowledge Base Doc Generation — Per-Subagent Instructions
+
+You are generating **ONE** knowledge base document. You have been given:
+
+1. A **discovery context** — the raw findings from Phase 1 discovery scans,
+   passed inline in your prompt
+2. A **doc spec** — which file to write and what it should contain
+3. A **project brief** (`.forge/init-context.md`) — for names and paths
+
+Your job is to produce exactly one file and return a one-line status.
+
+---
+
+## Rules
+
+1. **Write EXACTLY ONE file** at the path specified in your doc spec.
+
+2. **Confidence header** — every generated doc must open with:
+   ```
+   <!-- AUTO-GENERATED by /forge:init — confidence: N% -->
+   ```
+   Set N% based on how much evidence the discovery context provided:
+   - 90–100%: directly observed in code/config
+   - 70–89%: inferred from conventions or partial evidence
+   - below 70%: limited evidence, many `[?]` markers expected
+
+3. **Uncertainty markers** — any fact not directly observed in the discovery
+   context must be marked with `[?]`. Do not invent values.
+
+4. **Entity names** — use entity names exactly as they appear in the brief's
+   `## Domain Entities` section. Do not rename or abbreviate.
+
+5. **Scope discipline** — generate only what the doc spec prescribes.
+   Do not add sections not listed in the spec. Do not cross-reference
+   other KB docs that do not yet exist.
+
+6. **`architecture/INDEX.md` and `business-domain/INDEX.md`** — if your
+   assigned doc is an INDEX file, link only to docs that exist on disk at
+   the time you write. Do not anticipate files that may not have been written.
+
+---
+
+## Self-check (mandatory last step)
+
+After writing the file, verify before returning:
+
+1. Read back the written file
+2. Confirm the confidence header is present on the first line
+3. Confirm no `{placeholder}` tokens remain
+4. Record in the manifest:
+   ```sh
+   node "$FORGE_ROOT/tools/generation-manifest.cjs" record "{output_path}"
+   ```
+   (If generation-manifest.cjs is not yet installed, skip silently.)
+
+5. Return **exactly one line**:
+   - `done: <first 80 chars of the written file>` — on success
+   - `FAILED: <reason>` — if any step above failed or the file could not be written
+
+Do not output anything else after the status line.

package/dist/forge-payload/.schemas/bug.schema.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "forge/bug.schema.json",
+  "title": "Bug",
+  "type": "object",
+  "required": ["bugId", "title", "severity", "status", "path", "reportedAt"],
+  "properties": {
+    "bugId":               { "type": "string" },
+    "title":               { "type": "string" },
+    "description":         { "type": "string" },
+    "severity":            { "type": "string", "enum": ["critical", "major", "minor"] },
+    "status":              { "type": "string", "enum": ["reported", "triaged", "in-progress", "fixed", "verified"] },
+    "path":                { "type": "string" },
+    "rootCauseCategory": {
+      "type": "string",
+      "enum": ["validation", "auth", "business-rule", "data-integrity", "race-condition", "integration", "configuration", "regression"]
+    },
+    "similarBugs":         { "type": "array", "items": { "type": "string" } },
+    "checklistItemAdded":  { "type": "boolean" },
+    "businessRuleUpdated": { "type": "boolean" },
+    "githubIssue":         { "type": "string", "format": "uri" },
+    "reportedAt":          { "type": "string", "format": "date-time" },
+    "resolvedAt":          { "type": "string", "format": "date-time" },
+    "summaries": {
+      "type": "object",
+      "description": "Terse structured summaries of phase artifacts. Optional; full artifacts on disk remain authoritative.",
+      "properties": {
+        "plan":           { "$ref": "#/$defs/phaseSummary" },
+        "review_plan":    { "$ref": "#/$defs/phaseSummary" },
+        "implementation": { "$ref": "#/$defs/phaseSummary" },
+        "code_review":    { "$ref": "#/$defs/phaseSummary" },
+        "validation":     { "$ref": "#/$defs/phaseSummary" }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "phaseSummary": {
+      "type": "object",
+      "required": ["objective", "written_at"],
+      "properties": {
+        "objective":   { "type": "string", "maxLength": 280 },
+        "key_changes": { "type": "array", "items": { "type": "string", "maxLength": 200 }, "maxItems": 12 },
+        "findings":    { "type": "array", "items": { "type": "string", "maxLength": 200 }, "maxItems": 12 },
+        "verdict":     { "type": "string", "enum": ["approved", "revision", "n/a"] },
+        "written_at":  { "type": "string", "format": "date-time" },
+        "artifact_ref":{ "type": "string", "description": "Relative path to the full artifact" }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/dist/forge-payload/.schemas/collation-state.schema.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "forge/collation-state.schema.json",
+  "title": "Collation State",
+  "description": "Last-collation watermark written to .forge/store/COLLATION_STATE.json",
+  "type": "object",
+  "required": ["collatedAt", "featureCount", "sprintCount", "taskCount", "bugCount"],
+  "additionalProperties": false,
+  "properties": {
+    "collatedAt":   { "type": "string",  "format": "date-time" },
+    "featureCount": { "type": "integer", "minimum": 0 },
+    "sprintCount":  { "type": "integer", "minimum": 0 },
+    "taskCount":    { "type": "integer", "minimum": 0 },
+    "bugCount":     { "type": "integer", "minimum": 0 }
+  }
+}

package/dist/forge-payload/.schemas/event-sidecar.schema.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "forge/event-sidecar.schema.json",
+  "title": "Event Sidecar",
+  "description": "Subset of event schema — token/cost/duration fields written by agents before canonical merge. All fields other than eventId are optional; presence enforcement happens on the canonical event, not the sidecar.",
+  "type": "object",
+  "required": ["eventId"],
+  "additionalProperties": false,
+  "properties": {
+    "eventId":          { "type": "string", "minLength": 1 },
+    "inputTokens":      { "type": "integer", "minimum": 0 },
+    "outputTokens":     { "type": "integer", "minimum": 0 },
+    "cacheReadTokens":  { "type": "integer", "minimum": 0 },
+    "cacheWriteTokens": { "type": "integer", "minimum": 0 },
+    "estimatedCostUSD": { "type": "number",  "minimum": 0 },
+    "model":            { "type": "string",  "maxLength": 120 },
+    "durationMinutes":  { "type": "number",  "minimum": 0 },
+    "startTimestamp":   { "type": "string",  "format": "date-time" },
+    "endTimestamp":     { "type": "string",  "format": "date-time" },
+    "tokenSource":      { "type": "string",  "enum": ["reported", "estimated"] }
+  }
+}

package/dist/forge-payload/.schemas/event.schema.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "forge/event.schema.json",
+  "title": "Event",
+  "type": "object",
+  "required": [
+    "eventId", "taskId", "sprintId", "role", "action",
+    "phase", "iteration", "startTimestamp", "endTimestamp", "durationMinutes", "model"
+  ],
+  "properties": {
+    "eventId":         { "type": "string" },
+    "taskId":          { "type": "string" },
+    "sprintId":        { "type": "string" },
+    "role":            { "type": "string" },
+    "action":          { "type": "string" },
+    "phase":           { "type": "string" },
+    "iteration":       { "type": "integer", "minimum": 1 },
+    "startTimestamp":  { "type": "string", "format": "date-time" },
+    "endTimestamp":    { "type": "string", "format": "date-time" },
+    "durationMinutes": { "type": "number", "minimum": 0 },
+    "model":           { "type": "string" },
+    "verdict":            { "type": "string" },
+    "notes":              { "type": "string" },
+    "inputTokens":        { "type": "integer", "minimum": 0 },
+    "outputTokens":       { "type": "integer", "minimum": 0 },
+    "cacheReadTokens":    { "type": "integer", "minimum": 0 },
+    "cacheWriteTokens":   { "type": "integer", "minimum": 0 },
+    "estimatedCostUSD":   { "type": "number",  "minimum": 0 },
+    "tokenSource":        { "type": "string",  "enum": ["reported", "estimated"] }
+  },
+  "additionalProperties": false
+}

package/dist/forge-payload/.schemas/feature.schema.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "forge/feature.schema.json",
+  "title": "Feature",
+  "type": "object",
+  "required": ["id", "title", "status", "created_at"],
+  "properties": {
+    "id": { "type": "string" },
+    "title": { "type": "string" },
+    "description": { "type": "string" },
+    "status": {
+      "type": "string",
+      "enum": ["draft", "active", "shipped", "retired"]
+    },
+    "requirements": { "type": "array", "items": { "type": "string" } },
+    "sprints":      { "type": "array", "items": { "type": "string" } },
+    "tasks":        { "type": "array", "items": { "type": "string" } },
+    "created_at":   { "type": "string", "format": "date-time" },
+    "updated_at":   { "type": "string", "format": "date-time" }
+  },
+  "additionalProperties": false
+}

package/dist/forge-payload/.schemas/progress-entry.schema.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "forge/progress-entry.schema.json",
+  "title": "Progress Entry",
+  "description": "One line of progress.log, parsed from pipe-delimited fields: timestamp|agentName|bannerKey|status|detail",
+  "type": "object",
+  "required": ["timestamp", "agentName", "bannerKey", "status"],
+  "additionalProperties": false,
+  "properties": {
+    "timestamp": { "type": "string", "format": "date-time" },
+    "agentName": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]{0,63}$" },
+    "bannerKey": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_.:-]{0,127}$" },
+    "status":    { "type": "string", "enum": ["start", "progress", "done", "error"] },
+    "detail":    { "type": "string", "maxLength": 500 }
+  }
+}