npm - @namewta/speculo - Versions diffs - 1.0.1 → 1.0.3 - Mend

@namewta/speculo 1.0.1 → 1.0.3

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.

Files changed (128) hide show

package/README.md CHANGED Viewed

@@ -67,12 +67,13 @@ After initialization, the target project gains the following AI agent-callable a
 | `engineering-standards-builder` | Interview-driven generator that produces a project-specific TypeScript/JS/React/Node standards skill |
 | `writing-great-skills` | Authoring guidance for agent skills |
-### 3 Workflow Packages
+### 4 Workflow Packages
 | Workflow | Work Entries | Description |
 |---|---:|---|
 | **learning** | 7 | Evidence-aware learning for projects, products, subjects, languages, and skills: complete 30–40 minute plain-language lessons, single-file homework review, optional retention review, and provenance-preserving topic synthesis |
-| **specdev** | 13 | Local-first specification-driven development: archive, code review, diagnosis, grilling, implementation, setup, goal planning, prototyping, architecture review, specs, tickets, triage, and wayfinding |
+| **specdev** | 14 | Local-first specification-driven development: archive, code review, diagnosis, grilling, implementation, setup, learning, goal planning, prototyping, architecture review, specs, tickets, triage, and wayfinding |
+| **ops** | 4 | Operations assessment, approval, execution, verification, and archival knowledge |
 | **person** | 2 | Persona-methodology and rigorous deliberation workflows (Mao Zedong Cognitive OS; Bidirectional Steelman Deliberation) |
 Every workflow ships an `INDEX.md` as its auto-generated work catalog. Work entries follow `<Letter>-<work_name>/<Letter>-<work_name>.md` naming with progressive-disclosure sub-files, and resolve runtime paths via `<Path>{roots.xxx}/...</Path>` pointers in `workspace.json`.
@@ -81,7 +82,7 @@ Every workflow ships an `INDEX.md` as its auto-generated work catalog. Work entr
 - [AGENTS.md](./AGENTS.md) — AI agent handbook (authoritative)
 - [CHANGELOG.md](./CHANGELOG.md) — Release history
-- [.agents/skills/](./.agents/skills/) — Internal authoring tools for Speculo maintainers (self-contained authoring contracts under `_shared/` and per-skill `references/`)
+- [skills/](./skills/) — Internal authoring tools for Speculo maintainers (self-contained authoring contracts under `_shared/` and per-skill `references/`)
 - [README-ZH.md](./README-ZH.md) — 中文镜像
 ## Acknowledgments — Honoring Open Source Heritage
@@ -99,3 +100,7 @@ Speculo synthesizes lessons from all: from failure we learned "documents are the
 ## License
 MIT — see [LICENSE](./LICENSE)
+## SpecDev Goal migration
+The unified P Goal entry, O compatibility route, Initiative exploration and Plan Ticket contracts are documented in [the migration guide](docs/specdev-goal-migration.md). Existing runtime state is not silently rewritten.

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@namewta/speculo",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Workflow-packaged AI collaboration assets with state-safe refresh tooling.",
   "type": "module",
   "bin": {
@@ -13,7 +13,7 @@
     "pretest": "pnpm build",
     "generate-canonical": "node scripts/generate-specdev-canonical.mjs",
     "validate-source-parity": "node scripts/check-specdev-source-parity.mjs",
-    "validate-assets": "node scripts/check-specdev-source-parity.mjs && node scripts/generate-specdev-canonical.mjs --check && node scripts/validate-refresh-contracts.mjs && node scripts/validate-framework-assets.mjs && node scripts/check-template-links.mjs",
+    "validate-assets": "node scripts/check-specdev-source-parity.mjs && node scripts/generate-specdev-canonical.mjs --check && node scripts/validate-refresh-contracts.mjs && node scripts/validate-framework-assets.mjs && node scripts/check-template-links.mjs && node scripts/validate-workflow-disclosure.mjs && node template/workflows/specdev/common/tools/validate-specdev.mjs --self-check",
     "check": "pnpm test && pnpm validate-assets",
     "verify-bin": "node scripts/verify-bin.mjs",
     "eval:scenarios": "node scripts/evaluate-scenarios.mjs",

package/template/AGENTS.md CHANGED Viewed

@@ -1 +1,14 @@
-# AGENTS.md
+# Speculo runtime guide
+先按当前任务定位相关 workflow、command、skill 或 change，再读取对应入口和分支 reference；不默认整读 `speculo/` 或永久知识索引。
+- 被动发现：按关键词/ID 搜索 `speculo/workflows/<workflow>/INDEX.md` 的相关行，只定位与当前请求相关的永久知识条目。
+- 激活 workflow：再读取对应 `README.md`、状态投影和当前 Work；只加载当前分支需要的规则、schema、模板与工具。
+- 记忆检索：先定位索引 entry，再回读少量原文和 provenance；没有匹配证据时停止猜测。
+- 记忆写入：先解析 owner/gateway，检查 pending transaction、lock 和 recovery evidence；网关未知时阻塞该写入并继续独立工作。
+- 只读探索、静态编辑和本地测试可直接进行；提交、推送、发布、部署、远程写入、归档移动、永久知识改写和不可逆操作必须由拥有该动作的入口取得明确授权。
+- 失败、漂移、schema 冲突、越界路径或 owner 不明时停止受影响分支，保留证据并报告恢复路径。
+详细状态、所有权和副作用合同由各 workflow 的 `INDEX.md`、`README.md`、`common/rules/` 和 schema 定义。
+编辑任何文档时，读取 `<Path>{roots.skills}/writing-great-skills/references/document-contract.md</Path>` 的保真合同（不自动激活该 Skill）。保留能力、用户明确的交付数量、默认工具、验收与失败停止条件；模式专属流程和长示例按明确入口下沉。真实源优先，保留软链接、许可与必要元数据，不修改系统/插件缓存。交付实际修改、完整前后字符统计、备份、验证和未完成项；没有实际用量对比不宣称 Token 或额度节省比例。