@moretea-labs/forge 1.7.1 → 1.8.0

package/assets/workflow-contract.v1.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.4.0",
+  "version": "1.5.0",
   "contractId": "tasks-first-harness-v1",
   "compatibility": {
     "agents": [
@@ -120,7 +120,6 @@
       "architecture-event.ts",
       "capability-config.ts",
       "architecture-queue.sh",
-      "archive-architecture-request.sh",
       "context-contract-sync.sh",
       "workstream-sync.sh",
       "prepare-codex-handoff.sh",
@@ -130,120 +129,18 @@
     "runtimeSource": "package"
   },
   "artifacts": {
-    "runtimeManifest": ".ai/harness/workflow-contract.json",
+    "runtimeManifest": "forge.config.json",
     "requiredDirectories": [
-      "plans",
-      "plans/archive",
-      "plans/prds",
-      "plans/sprints",
-      "tasks",
-      "tasks/issues",
-      "tasks/archive",
-      "tasks/contracts",
-      "tasks/reviews",
-      "tasks/notes",
-      "tasks/workstreams",
-      ".claude/templates",
-      ".ai/context",
-      ".ai/harness",
-      ".ai/harness/checks",
-      ".ai/harness/failures",
-      ".ai/harness/session",
-      ".ai/harness/controller/packets",
-      ".ai/harness/projections",
-      ".ai/harness/transfers",
-      ".ai/harness/security",
-      ".ai/harness/planning",
-      ".ai/harness/architecture",
-      ".ai/harness/worktrees",
-      ".ai/harness/runs",
-      ".ai/harness/jobs",
-      ".ai/harness/local-jobs",
-      ".ai/harness/controller",
-      ".ai/harness/edit-sessions",
-      "docs/architecture",
-      "docs/architecture/domains",
-      "docs/architecture/modules",
-      "docs/architecture/requests",
-      "docs/architecture/snapshots",
-      "docs/architecture/diagrams",
+      "docs",
       "docs/reference-configs",
-      "deploy",
-      "deploy/env",
-      "deploy/scripts",
-      "deploy/submissions",
-      "deploy/runbooks",
-      "deploy/release-checklists",
-      "deploy/sql",
       "docs/researches",
-      "scripts"
+      "tasks"
     ],
     "requiredFiles": [
+      "forge.config.json",
       "docs/spec.md",
-      ".claude/templates/spec.template.md",
-      ".claude/templates/plan.template.md",
-      ".claude/templates/research.template.md",
-      ".claude/templates/contract.template.md",
-      ".claude/templates/review.template.md",
-      ".claude/templates/implementation-notes.template.md",
-      "scripts/new-spec.sh",
-      "scripts/new-sprint.sh",
-      "scripts/new-plan.sh",
-      "scripts/capture-plan.sh",
-      "scripts/plan-to-todo.sh",
-      "scripts/contract-run.ts",
-      "scripts/contract-worktree.sh",
-      "scripts/ship-worktrees.sh",
-      "scripts/archive-workflow.sh",
-      "scripts/refresh-current-status.sh",
-      "scripts/prepare-handoff.sh",
-      "scripts/verify-contract.sh",
-      "scripts/summarize-failures.sh",
-      "scripts/verify-sprint.sh",
-      "scripts/sprint-backlog.sh",
-      "scripts/check-task-sync.sh",
-      "scripts/check-deploy-sql-order.sh",
-      "scripts/check-architecture-sync.sh",
-      "scripts/check-agent-tooling.sh",
-      "scripts/check-context-files.sh",
-      "scripts/sync-brain-docs.sh",
-      "scripts/check-skill-version.ts",
-      "scripts/select-agent-context-blocks.sh",
-      "scripts/ensure-task-workflow.sh",
-      "scripts/check-task-workflow.sh",
-      "scripts/switch-plan.sh",
-      "scripts/workflow-contract.ts",
-      "scripts/inspect-project-state.ts",
-      "scripts/migrate-workflow-docs.ts",
-      "scripts/migrate-project-template.sh",
-      "scripts/capability-resolver.ts",
-      "scripts/architecture-event.ts",
-      "scripts/capability-config.ts",
-      "scripts/architecture-queue.sh",
-      "scripts/archive-architecture-request.sh",
-      "scripts/context-contract-sync.sh",
-      "scripts/workstream-sync.sh",
-      "scripts/prepare-codex-handoff.sh",
-      "scripts/codex-handoff-resume.sh",
-      "tasks/current.md",
       "tasks/todos.md",
-      "tasks/lessons.md",
-      "docs/architecture/index.md",
-      ".ai/context/context-map.json",
-      ".ai/context/capabilities.json",
-      ".ai/context/capability-source-map.json",
-      ".ai/harness/policy.json",
-      ".ai/harness/brain-manifest.json",
-      ".ai/harness/workflow-contract.json",
-      "docs/reference-configs/harness-overview.md",
-      "docs/reference-configs/agentic-development-flow.md",
-      "docs/reference-configs/external-tooling.md",
-      "docs/reference-configs/sprint-contracts.md",
-      "docs/reference-configs/handoff-protocol.md",
-      "docs/reference-configs/document-generation.md",
-      "docs/reference-configs/global-working-rules.md",
-      "deploy/README.md",
-      "docs/researches/README.md"
+      "tasks/lessons.md"
     ],
     "runtimeFiles": [
       ".ai/harness/checks/latest.json",
@@ -263,15 +160,47 @@
       ".ai/harness/worktrees/",
       ".ai/harness/runs/.gitkeep",
       ".ai/harness/local-jobs/",
-      ".ai/harness/controller/"
+      ".ai/harness/controller/",
+      ".ai/harness/",
+      ".forge/plugins/",
+      ".forge/browser/",
+      ".forge/interactions/",
+      "_ops/",
+      ".repo-harness/",
+      ".codegraph/"
+    ],
+    "legacyRuntimePaths": [
+      ".ai/harness/checks/latest.json",
+      ".ai/harness/checks/post-bash-latest.json",
+      ".ai/harness/events.jsonl",
+      ".ai/harness/archive/",
+      ".ai/harness/failures/latest.jsonl",
+      ".ai/harness/session/continuation.md",
+      ".ai/harness/session/resume.md",
+      ".ai/harness/capability-context/",
+      ".ai/harness/security/.gitkeep",
+      ".ai/harness/planning/",
+      ".ai/harness/architecture/events.jsonl",
+      ".ai/harness/active-plan",
+      ".ai/harness/active-worktree",
+      ".ai/harness/sprint/",
+      ".ai/harness/worktrees/",
+      ".ai/harness/runs/.gitkeep",
+      ".ai/harness/local-jobs/",
+      ".ai/harness/controller/",
+      ".ai/harness/",
+      ".forge/plugins/",
+      ".forge/browser/",
+      ".forge/interactions/",
+      "_ops/",
+      ".repo-harness/",
+      ".codegraph/"
     ]
   },
   "documents": {
     "spec": "docs/spec.md",
-    "currentStatus": "tasks/current.md",
     "planDirectory": "plans",
     "deferredGoalLedger": "tasks/todos.md",
-    "implementationNotesDirectory": "tasks/notes",
     "lessonsLog": "tasks/lessons.md",
     "researchReportsDirectory": "docs/researches"
   },
@@ -310,21 +239,6 @@
           ""
         ]
       },
-      "currentStatus": {
-        "document": "currentStatus",
-        "reason": "Create tracked current-status snapshot when missing",
-        "lines": [
-          "# Current Status Snapshot",
-          "",
-          "<!-- generated-by: forge refresh-current-status v1 -->",
-          "",
-          "> **Status**: Idle",
-          "> **Reason**: forge adoption bootstrap",
-          "",
-          "This file is a tracked mainline snapshot derived from repo artifacts. It is not a live lock, not a kanban board, and not an implementation gate.",
-          ""
-        ]
-      },
       "lessonsLog": {
         "document": "lessonsLog",
         "reason": "Create correction-derived lessons ledger when missing",
@@ -365,13 +279,12 @@
       ],
       "actionClasses": [
         "preserve",
-        "archive",
         "reconfigure",
         "remove"
       ],
       "safety": {
         "removeOnlyOwnership": "known_generated",
-        "unknownFiles": "preserve-or-archive",
+        "unknownFiles": "preserve",
         "customHooks": "preserve",
         "ignoredReferenceMaterial": "preserve",
         "localSecrets": "preserve"
@@ -380,74 +293,57 @@
         {
           "id": "legacy-docs-plan",
           "signal": "legacy-docs-plan",
-          "action": "archive",
+          "action": "preserve",
           "risk": "low",
           "ownership": "user_authored",
           "paths": [
             "docs/plan.md"
           ],
-          "targetPaths": [
-            "plans/archive/legacy-docs-plan.md"
-          ],
-          "summary": "Archive the legacy plan document before refreshing the tasks-first workflow."
+          "summary": "Preserve the legacy plan in place and require explicit currentness triage before promotion or removal."
         },
         {
           "id": "legacy-docs-todo",
           "signal": "legacy-docs-todo",
-          "action": "archive",
+          "action": "preserve",
           "risk": "low",
           "ownership": "user_authored",
           "paths": [
             "docs/TODO.md"
           ],
-          "targetPaths": [
-            "tasks/archive/legacy-docs-TODO.md"
-          ],
-          "summary": "Archive the legacy checklist before writing the active task projection."
+          "summary": "Preserve the legacy checklist in place and require explicit triage instead of manufacturing a parallel archive."
         },
         {
           "id": "legacy-docs-progress",
           "signal": "legacy-docs-progress",
-          "action": "archive",
+          "action": "preserve",
           "risk": "medium",
           "ownership": "user_authored",
           "paths": [
             "docs/PROGRESS.md"
           ],
-          "targetPaths": [
-            "docs/researches/legacy-progress-import.md",
-            "tasks/archive/legacy-docs-PROGRESS.md"
-          ],
-          "summary": "Move execution-log style progress content into research reports and archive surfaces."
+          "summary": "Preserve legacy progress content in place; explicitly distill current knowledge instead of auto-copying execution history."
         },
         {
           "id": "legacy-singular-todo-file",
           "signal": "legacy-singular-todo-file",
-          "action": "archive",
+          "action": "preserve",
           "risk": "low",
           "ownership": "user_authored",
           "paths": [
             "tasks/todo.md"
           ],
-          "targetPaths": [
-            "tasks/todos.md",
-            "tasks/archive/legacy-tasks-todo.md"
-          ],
-          "summary": "Archive the legacy singular todo ledger and normalize the canonical deferred-goal ledger to tasks/todos.md."
+          "summary": "Preserve the legacy singular todo ledger in place until a maintainer explicitly classifies each still-current item."
         },
         {
           "id": "legacy-task-checklist-format",
           "signal": "legacy-task-checklist-format",
-          "action": "archive",
+          "action": "preserve",
           "risk": "medium",
           "ownership": "user_authored",
           "paths": [
             "tasks/todos.md"
           ],
-          "targetPaths": [
-            "tasks/archive/legacy-tasks-todo.md"
-          ],
-          "summary": "Archive old task checklists before rewriting tasks/todos.md as the active execution projection."
+          "summary": "Preserve a non-canonical tasks/todos.md in place and fail closed until its user-authored checklist is explicitly triaged."
         },
         {
           "id": "legacy-task-sprint-prds",
@@ -498,7 +394,6 @@
             "scripts/architecture-drift.sh",
             "scripts/architecture-event.ts",
             "scripts/architecture-queue.sh",
-            "scripts/archive-architecture-request.sh",
             "scripts/archive-workflow.sh",
             "scripts/capability-config.ts",
             "scripts/capability-resolver.ts",
@@ -509,16 +404,16 @@
             "scripts/check-context-files.sh",
             "scripts/check-deploy-sql-order.sh",
             "scripts/check-skill-version.ts",
-        "scripts/check-task-sync.sh",
-        "scripts/check-task-workflow.sh",
-        "scripts/harness-trace-grade.sh",
-        "scripts/codex-handoff-resume.sh",
+            "scripts/check-task-sync.sh",
+            "scripts/check-task-workflow.sh",
+            "scripts/harness-trace-grade.sh",
+            "scripts/codex-handoff-resume.sh",
             "scripts/context-contract-sync.sh",
-        "scripts/contract-run.ts",
-        "scripts/contract-worktree.sh",
-        "scripts/ensure-task-workflow.sh",
-        "scripts/heartbeat-triage.sh",
-        "scripts/inspect-project-state.ts",
+            "scripts/contract-run.ts",
+            "scripts/contract-worktree.sh",
+            "scripts/ensure-task-workflow.sh",
+            "scripts/heartbeat-triage.sh",
+            "scripts/inspect-project-state.ts",
             "scripts/maintenance-triage.sh",
             "scripts/migrate-project-template.sh",
             "scripts/migrate-workflow-docs.ts",
@@ -648,16 +543,13 @@
         {
           "id": "legacy-tasks-research-notes",
           "signal": "legacy-tasks-research-notes",
-          "action": "archive",
+          "action": "preserve",
           "risk": "medium",
           "ownership": "user_authored",
           "paths": [
             "tasks/research.md"
           ],
-          "targetPaths": [
-            "docs/researches/legacy-research-notes.md"
-          ],
-          "summary": "Archive legacy singleton research notes into the docs/researches report surface and leave a tombstone pointer."
+          "summary": "Preserve legacy singleton research notes in place until still-current findings are explicitly promoted; do not create a duplicate report authority."
         }
       ]
     }

package/assets/workflows/xiaohongshu/xiaohongshu.collect-metrics.v1.draft.json

@@ -0,0 +1,118 @@
+{
+  "schemaVersion": 1,
+  "workflowId": "xiaohongshu.collect-metrics",
+  "version": "1",
+  "title": "Xiaohongshu metrics observation bootstrap",
+  "description": "Read-only bootstrap for a real post page. It captures bounded observed text and a digest but intentionally does not invent metric selectors or values before a real page contract is observed.",
+  "inputContract": {
+    "session_id": {
+      "type": "string",
+      "required": true
+    },
+    "account": {
+      "type": "string",
+      "required": true
+    },
+    "post_id": {
+      "type": "string",
+      "required": true
+    },
+    "post_url": {
+      "type": "string",
+      "required": true
+    }
+  },
+  "requiredCapabilities": [
+    "browser.get_text",
+    "browser.navigate",
+    "browser.verify_state"
+  ],
+  "steps": [
+    {
+      "stepId": "metrics.navigate_post",
+      "capabilityId": "browser.navigate",
+      "input": {
+        "session_id": "{{input.session_id}}",
+        "url": "{{input.post_url}}",
+        "wait_until": "domcontentloaded",
+        "timeout_ms": 60000
+      }
+    },
+    {
+      "stepId": "metrics.verify_auth",
+      "capabilityId": "browser.verify_state",
+      "input": {
+        "session_id": "{{input.session_id}}",
+        "url_contains_none": [
+          "/login",
+          "passport.xiaohongshu.com",
+          "login.xiaohongshu.com"
+        ],
+        "text_contains_none": [
+          "手机号登录",
+          "扫码登录",
+          "验证码登录"
+        ],
+        "max_chars": 8000
+      },
+      "outputContract": {
+        "matched": {
+          "type": "boolean",
+          "required": true
+        },
+        "observedUrl": {
+          "type": "string",
+          "required": true
+        }
+      }
+    },
+    {
+      "stepId": "metrics.observe_text",
+      "capabilityId": "browser.get_text",
+      "input": {
+        "session_id": "{{input.session_id}}",
+        "max_chars": 20000
+      },
+      "outputContract": {
+        "text": {
+          "type": "string",
+          "required": true
+        },
+        "url": {
+          "type": "string",
+          "required": true
+        }
+      }
+    },
+    {
+      "stepId": "metrics.contract_status",
+      "kind": "script",
+      "scriptRef": "metricContractStatus",
+      "input": {
+        "text": "{{output.metrics.observe_text.text}}"
+      },
+      "outputContract": {
+        "observation_text_digest": {
+          "type": "string",
+          "required": true
+        },
+        "metric_contract_status": {
+          "type": "string",
+          "required": true
+        }
+      }
+    }
+  ],
+  "scripts": {
+    "metricContractStatus": {
+      "runtime": "node",
+      "body": "const crypto=require('crypto'); const input=JSON.parse(process.argv[1]||'{}'); const text=String(input.text||''); process.stdout.write(JSON.stringify({ observation_text_digest:'sha256:'+crypto.createHash('sha256').update(text).digest('hex'), metric_contract_status:'observation_required' }));",
+      "deterministic": true,
+      "outputFormat": "json"
+    }
+  },
+  "resources": {
+    "metricContract": "observation_required",
+    "policy": "Do not infer or zero-fill metrics until a real Xiaohongshu page observation establishes a versioned selector/label contract."
+  }
+}