@openprd/cli 0.1.0

package/.openprd/schema/diagram-architecture.schema.yaml

@@ -0,0 +1,49 @@
+name: diagram-architecture
+version: 1
+description: Minimal contract for OpenPrd architecture diagrams
+
+requiredFields:
+  - type
+  - title
+  - components
+  - flows
+  - summaryCards
+  - metadata.versionId
+  - metadata.reviewStatus
+
+requiredArrays:
+  components: 2
+  flows: 1
+  summaryCards: 1
+  reviewInstructions: 1
+
+itemRequiredFields:
+  components:
+    - id
+    - name
+    - type
+  flows:
+    - source
+    - target
+    - label
+  summaryCards:
+    - title
+    - items
+
+allowedValues:
+  type:
+    - architecture
+  metadata.reviewStatus:
+    - pending-confirmation
+    - confirmed
+    - needs-revision
+
+itemAllowedValues:
+  components:
+    type:
+      - frontend
+      - backend
+      - database
+      - cloud
+      - security
+      - external

package/.openprd/schema/diagram-product-flow.schema.yaml

@@ -0,0 +1,52 @@
+name: diagram-product-flow
+version: 1
+description: Minimal contract for OpenPrd product flow diagrams
+
+requiredFields:
+  - type
+  - title
+  - steps
+  - transitions
+  - summaryCards
+  - metadata.reviewStatus
+
+requiredArrays:
+  actors: 1
+  steps: 3
+  transitions: 2
+  summaryCards: 1
+  reviewInstructions: 1
+
+itemRequiredFields:
+  steps:
+    - id
+    - name
+    - type
+  transitions:
+    - from|from_step_id
+    - to|to_step_id
+    - label
+  summaryCards:
+    - title
+    - items
+
+allowedValues:
+  type:
+    - product-flow
+  metadata.reviewStatus:
+    - pending-confirmation
+    - confirmed
+    - needs-revision
+
+itemAllowedValues:
+  steps:
+    type:
+      - user_action
+      - system_process
+      - decision
+      - success
+      - error_path
+  transitions:
+    type:
+      - standard
+      - error_path

package/.openprd/schema/prd.schema.yaml

@@ -0,0 +1,121 @@
+name: prd-core
+version: 1
+description: Canonical PRD schema for OpenPrd
+
+sections:
+  meta:
+    requiredFields:
+      - title
+      - owner
+      - version
+      - status
+      - productType
+
+  problem:
+    requiredFields:
+      - problemStatement
+      - whyNow
+      - evidence
+
+  users:
+    requiredFields:
+      - primaryUsers
+      - stakeholders
+
+  goals:
+    requiredFields:
+      - successMetrics
+      - acceptanceGoals
+
+  scope:
+    requiredFields:
+      - inScope
+      - outOfScope
+
+  scenarios:
+    requiredFields:
+      - primaryFlows
+      - edgeCases
+      - failureModes
+
+  requirements:
+    requiredFields:
+      - functional
+      - nonFunctional
+
+  businessGuardrails:
+    conditional:
+      when:
+        - free users
+        - usage limits
+        - metered cost
+        - AI or third-party cost
+    requiredFields:
+      - costDrivers
+      - usageLimits
+      - abusePrevention
+      - monitoringSignals
+      - alertThresholds
+      - stopLossActions
+
+  constraints:
+    requiredFields:
+      - technical
+      - compliance
+      - dependency
+
+  risks:
+    requiredFields:
+      - assumptions
+      - risks
+      - openQuestions
+
+  handoff:
+    requiredFields:
+      - owner
+      - nextStep
+      - targetSystem
+
+extensions:
+  consumer:
+    requiredFields:
+      - persona
+      - journey
+      - activationMetric
+      - retentionMetric
+
+  b2b:
+    requiredFields:
+      - roles
+      - asIs
+      - toBe
+      - permissionMatrix
+      - approvalFlow
+
+  agent:
+    requiredFields:
+      - humanAgentContract
+      - autonomyBoundary
+      - toolBoundary
+      - stateModel
+      - evalPlan
+
+validation:
+  freeze:
+    mustHaveSections:
+      - meta
+      - problem
+      - users
+      - goals
+      - scope
+      - scenarios
+      - requirements
+      - businessGuardrails
+      - constraints
+      - risks
+
+  versioning:
+    strategy: semver
+    allowBreakingOnlyWith:
+      - explicitApproval
+      - migrationNote

package/.openprd/standards/config.json

@@ -0,0 +1,88 @@
+{
+  "version": 1,
+  "docsRoot": "docs/basic",
+  "requiredDocs": [
+    "file-structure.md",
+    "app-flow.md",
+    "prd.md",
+    "frontend-guidelines.md",
+    "backend-structure.md",
+    "tech-stack.md"
+  ],
+  "fileManual": {
+    "enabled": true,
+    "template": "file-manual-template.md",
+    "requiredSections": [
+      "核心功能",
+      "输入",
+      "输出",
+      "定位",
+      "依赖",
+      "维护规则"
+    ],
+    "placement": "file-header",
+    "ignorePaths": []
+  },
+  "folderManual": {
+    "enabled": true,
+    "template": "folder-readme-template.md",
+    "naming": "[module]_[folder]_README.md",
+    "requiredSections": [
+      "核心功能",
+      "输入",
+      "输出",
+      "定位",
+      "依赖",
+      "维护规则"
+    ],
+    "ignorePaths": []
+  },
+  "qualityGates": {
+    "changeValidateRequiresStandards": true,
+    "taskVerifyUsesStandards": true,
+    "discoveryVerifyRequiresStandards": true,
+    "sourceManuals": true
+  },
+  "developmentStandards": {
+    "codeFileLines": {
+      "enabled": true,
+      "okMax": 700,
+      "attentionMax": 1500,
+      "appliesTo": "agent-touched-code-files",
+      "codeFileExtensions": [],
+      "exemptPathSegments": [],
+      "exemptFilePatterns": []
+    }
+  },
+  "growth": {
+    "enabled": true,
+    "reviewRequired": true,
+    "candidateLimit": 200,
+    "scopes": [
+      "project",
+      "user-local",
+      "openprd-core"
+    ],
+    "supportedCandidateTypes": [
+      "code-extension",
+      "exempt-path-segment",
+      "exempt-file-pattern",
+      "user-preference",
+      "workflow-gotcha",
+      "standards-rule"
+    ],
+    "autoApply": {
+      "enabled": true,
+      "minConfidence": 0.8,
+      "safeTypes": [
+        "code-extension"
+      ]
+    }
+  },
+  "externalReferences": {
+    "paths": []
+  },
+  "sourceManual": {
+    "ignorePaths": []
+  }
+}

package/.openprd/standards/file-manual-template.md

@@ -0,0 +1,28 @@
+# 文件说明书模板
+
+文件说明书应位于代码文件起始位置，并根据文件类型使用对应注释语法。
+
+## 核心功能
+
+一句话描述该文件的核心职责。
+
+## 输入
+
+描述该文件接收的数据来源、参数或上游信号。
+
+## 输出
+
+描述该文件对外提供的方法、状态、事件或结果。
+
+## 定位
+
+描述该文件在当前模块或文件夹中的职责边界。
+
+## 依赖
+
+列出关键内部文件、模块或第三方依赖。
+
+## 维护规则
+
+- 每次修改代码逻辑后，必须检查并更新文件说明书。
+- 变更影响所在文件夹职责时，必须同步更新文件夹 README。

package/.openprd/standards/folder-readme-template.md

@@ -0,0 +1,28 @@
+# 文件夹说明书模板
+
+文件夹说明书应保存为当前目录下的 `[模块名]_[文件夹名]_README.md`。
+
+## 核心功能
+
+一句话描述该文件夹承载的能力和目标。
+
+## 输入
+
+描述进入该文件夹模块的数据、事件或上游依赖。
+
+## 输出
+
+描述该文件夹模块对外暴露的视图、服务、接口或数据。
+
+## 定位
+
+描述该文件夹在项目结构中的位置和职责边界。
+
+## 依赖
+
+列出关键内部模块、资源、服务和第三方依赖。
+
+## 维护规则
+
+- 每次新增、删除、移动文件或调整职责后，必须检查并更新本 README。
+- 文件夹职责影响项目基础文档时，必须同步更新 `docs/basic/`。

package/.openprd/state/changes.json

@@ -0,0 +1,12 @@
+{
+  "version": 1,
+  "activeChange": "verify-boundaries-and-historical-refresh",
+  "updatedAt": "2026-05-24 01:56:59",
+  "changes": {
+    "verify-boundaries-and-historical-refresh": {
+      "id": "verify-boundaries-and-historical-refresh",
+      "status": "active",
+      "activatedAt": "2026-05-24 01:56:59"
+    }
+  }
+}

package/.openprd/state/current.json

@@ -0,0 +1,169 @@
+{
+  "version": 1,
+  "status": "synthesized",
+  "activeEngagement": "active",
+  "prdVersion": 1,
+  "productType": "agent",
+  "templatePack": "agent",
+  "projectRoot": ".",
+  "workspaceRoot": ".openprd",
+  "createdAt": "2026-04-12T00:00:00.000Z",
+  "learningReview": {
+    "enabled": true,
+    "defaultGenre": "internet-product",
+    "autoOpen": true,
+    "sourceScope": "docs",
+    "lastPackageId": "lr-20260528-223815-openprd-典型协作场景",
+    "lastGeneratedAt": "2026-05-28 22:38:15",
+    "lastGenreId": "internet-product",
+    "lastTopic": "OpenPrd 典型协作场景",
+    "lastTrigger": "manual",
+    "lastOpened": true,
+    "lastStyleId": "teaching-brief",
+    "lastAuthoringStatus": "agent-authored"
+  },
+  "captureMeta": {
+    "meta.productType": {
+      "source": "user-confirmed",
+      "capturedAt": "2026-05-24 01:55:15"
+    },
+    "problem.problemStatement": {
+      "source": "user-confirmed",
+      "capturedAt": "2026-05-24 01:56:48"
+    },
+    "problem.whyNow": {
+      "source": "user-confirmed",
+      "capturedAt": "2026-05-24 01:56:48"
+    },
+    "users.primaryUsers": {
+      "source": "user-confirmed",
+      "capturedAt": "2026-05-24 01:55:27"
+    },
+    "goals.goals": {
+      "source": "user-confirmed",
+      "capturedAt": "2026-05-24 01:55:31"
+    },
+    "goals.successMetrics": {
+      "source": "user-confirmed",
+      "capturedAt": "2026-05-24 01:55:36"
+    },
+    "scope.inScope": {
+      "source": "user-confirmed",
+      "capturedAt": "2026-05-24 01:55:40"
+    },
+    "scope.outOfScope": {
+      "source": "user-confirmed",
+      "capturedAt": "2026-05-24 01:55:44"
+    },
+    "scenarios.primaryFlows": {
+      "source": "user-confirmed",
+      "capturedAt": "2026-05-24 01:55:49"
+    },
+    "goals.acceptanceGoals": {
+      "source": "user-confirmed",
+      "capturedAt": "2026-05-24 01:56:11"
+    },
+    "scenarios.failureModes": {
+      "source": "user-confirmed",
+      "capturedAt": "2026-05-24 01:56:15"
+    },
+    "risks.openQuestions": {
+      "source": "user-confirmed",
+      "capturedAt": "2026-05-24 01:56:20"
+    },
+    "typeSpecific.fields.humanAgentContract": {
+      "source": "user-confirmed",
+      "capturedAt": "2026-05-24 01:56:24"
+    },
+    "typeSpecific.fields.autonomyBoundary": {
+      "source": "user-confirmed",
+      "capturedAt": "2026-05-24 01:56:28"
+    },
+    "typeSpecific.fields.toolBoundary": {
+      "source": "user-confirmed",
+      "capturedAt": "2026-05-24 01:56:32"
+    },
+    "typeSpecific.fields.stateModel": {
+      "source": "user-confirmed",
+      "capturedAt": "2026-05-24 01:56:37"
+    },
+    "typeSpecific.fields.evalPlan": {
+      "source": "user-confirmed",
+      "capturedAt": "2026-05-24 01:56:41"
+    },
+    "meta.title": {
+      "source": "user-confirmed",
+      "capturedAt": "2026-05-24 01:56:48"
+    },
+    "meta.owner": {
+      "source": "user-confirmed",
+      "capturedAt": "2026-05-24 01:56:48"
+    }
+  },
+  "classifiedAt": "2026-05-24 01:55:15",
+  "problemStatement": "修复 OpenPrd 的 verify 边界，让 run/verify 和 standards/quality 默认不再把仓库中的外部参考目录当作当前项目源码或 reference discovery 结果混入主验证。",
+  "lastCapturedAt": "2026-05-24 01:56:41",
+  "whyNow": "现有行为会让历史项目的 verify 被外部参考目录噪音阻塞，也会把 reference discovery 直接带进 run 上下文，影响可用性和对门禁结果的信任。",
+  "primaryUsers": [
+    "维护 OpenPrd 的 Agent 工程师",
+    "使用 OpenPrd 管理历史项目的项目维护者"
+  ],
+  "goals": [
+    "让主验证只关注当前项目源码和当前实现门禁",
+    "让历史项目刷新后默认获得更干净的 verify 体验"
+  ],
+  "successMetrics": [
+    "存在 reference discovery 时 openprd run . --context 不再默认展示它",
+    "仓库内常见外部参考目录在未人工归类前不再直接把 standards verify 阻塞成大面积说明书噪音",
+    "openprd fleet 更新后历史项目生成物包含这次修复"
+  ],
+  "inScope": [
+    "调整 run context 与 run verify 对 discovery 的纳入规则",
+    "调整 standards/source-manual 默认对明显外部参考目录的处理策略",
+    "为历史项目执行 openprd fleet 更新与必要回填"
+  ],
+  "outOfScope": [
+    "不自动替每个历史项目猜测所有业务目录的 externalReferences 清单",
+    "不修改历史项目的业务代码或需求内容",
+    "不把人工确认 external reference 的能力删除"
+  ],
+  "primaryFlows": [
+    "维护者运行 openprd run . --context 或 openprd run . --verify 时，只看到当前项目主验证状态；仓库中存在 research、toolkit-sources、marketplace-candidates 等参考目录时，默认不会被当成本项目源码说明书缺口直接淹没结果；维护者可以继续按需显式 classify-external。"
+  ],
+  "acceptanceGoals": [
+    "run/verify 的默认结果不再把 reference discovery 或明显外部参考目录当成主门禁噪音",
+    "历史项目刷新后生成物能承接这次边界修复",
+    "对需要人工确认的 external reference 仍保留显式 classify-external 路径"
+  ],
+  "failureModes": [
+    "reference discovery 仍然混入 run context 或 run verify",
+    "standards verify 继续被 research 或 toolkit-sources 之类参考目录的说明书缺口淹没",
+    "fleet 更新后历史项目仍保留旧的 verify 噪音行为"
+  ],
+  "openQuestions": [
+    "本次只收敛默认边界，不自动猜测每个历史项目全部 external reference 清单；如果某些项目还需要更细的目录级归类，仍由维护者显式确认和补充"
+  ],
+  "humanAgentContract": "Agent 可以识别并提示 reference discovery 与外部参考目录边界，但把目录正式归类为 external reference 仍需要人确认；批量刷新历史项目可以自动执行。",
+  "autonomyBoundary": "Agent 可以修改 OpenPrd CLI、补测试、更新文档、运行 fleet dry-run 与 update-openprd/backfill-work-units，并验证结果；不得静默把任意历史目录永久归类为 external reference。",
+  "toolBoundary": "使用本地代码检索、OpenPrd CLI、自带测试、fleet 更新、doctor 与 verify 完成实现和验证；本次不需要外部第三方文档调研。",
+  "stateModel": "需要保留三类状态：当前项目源码验证状态、reference discovery 状态、standards external reference 显式配置；主 run/verify 只默认消费第一类，其他两类按边界显式暴露。",
+  "evalPlan": "通过针对 run-harness、standards 和 fleet 的单测与集成验证评估；再用历史项目 dry-run 与 update-openprd/backfill-work-units 验证刷新结果。",
+  "latestVersionId": "v0001",
+  "latestVersionDigest": "dc988d7a94c07d2a8070968a71ddacffb374eaeee12aa85eb93231e06dd7b077",
+  "activeWorkUnitId": "wu-20260524015648-6d33ded7",
+  "targetRoot": "/Users/chaojifeng/Projects/harness-engineer/openprd",
+  "reviewStatus": {
+    "versionId": "v0001",
+    "workUnitId": "wu-20260524015648-6d33ded7",
+    "status": "confirmed",
+    "artifact": "/Users/chaojifeng/Projects/harness-engineer/openprd/.openprd/engagements/active/review.html",
+    "stableArtifact": "/Users/chaojifeng/Projects/harness-engineer/openprd/.openprd/reviews/v0001.html",
+    "updatedAt": "2026-05-24 01:56:54",
+    "notes": "用户已明确要求直接修复 verify 边界并刷新历史项目。",
+    "reviewPath": "/Users/chaojifeng/Projects/harness-engineer/openprd/.openprd/reviews/v0001.html",
+    "entryPath": "/Users/chaojifeng/Projects/harness-engineer/openprd/.openprd/engagements/active/review.html"
+  },
+  "title": "Verify 边界与历史项目刷新",
+  "owner": "Codex",
+  "synthesizedAt": "2026-05-24 01:56:48"
+}

package/.openprd/state/version-index.json

@@ -0,0 +1,15 @@
+[
+  {
+    "versionNumber": 1,
+    "versionId": "v0001",
+    "createdAt": "2026-05-24 01:56:48",
+    "title": "Verify 边界与历史项目刷新",
+    "owner": "Codex",
+    "productType": "agent",
+    "templatePack": "agent",
+    "status": "synthesized",
+    "digest": "dc988d7a94c07d2a8070968a71ddacffb374eaeee12aa85eb93231e06dd7b077",
+    "workUnitId": "wu-20260524015648-6d33ded7",
+    "targetRoot": "/Users/chaojifeng/Projects/harness-engineer/openprd"
+  }
+]