@namewta/speculo 0.7.1 → 0.7.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.
Files changed (37) hide show
  1. package/README.md +2 -1
  2. package/package.json +1 -1
  3. package/template/canonical/canonical-specdev-engineering-cognitive-mentor.md +178 -0
  4. package/template/canonical/canonical-specdev-goal-plan.md +386 -74
  5. package/template/canonical/canonical-specdev-grill-with-docs.md +178 -0
  6. package/template/canonical/canonical-specdev-spec.md +178 -0
  7. package/template/canonical/canonical-specdev-tickets.md +247 -21
  8. package/template/canonical/canonical-specdev-wayfinder.md +178 -0
  9. package/template/skills/optimize-codex-config/SKILL.md +81 -0
  10. package/template/skills/optimize-codex-config/references/configuration-contract.md +103 -0
  11. package/template/skills/optimize-codex-config/references/troubleshooting.md +79 -0
  12. package/template/skills/optimize-codex-config/scripts/audit-codex-config.mjs +747 -0
  13. package/template/workflows/specdev/I-implement/I-implement.md +11 -10
  14. package/template/workflows/specdev/I-implement/delegated-evidence-template.md +2 -1
  15. package/template/workflows/specdev/I-implement/execution-preflight.md +5 -3
  16. package/template/workflows/specdev/I-implement/merge-conflict-protocol.md +6 -5
  17. package/template/workflows/specdev/INDEX.md +5 -4
  18. package/template/workflows/specdev/P-goal-plan/P-goal-plan.md +27 -18
  19. package/template/workflows/specdev/P-goal-plan/completion-control.md +3 -3
  20. package/template/workflows/specdev/P-goal-plan/delegated-execution-template.md +6 -4
  21. package/template/workflows/specdev/P-goal-plan/delegated-execution.md +13 -7
  22. package/template/workflows/specdev/P-goal-plan/goal-plan-template.md +11 -2
  23. package/template/workflows/specdev/P-goal-plan/orchestration-protocol.md +7 -3
  24. package/template/workflows/specdev/P-goal-plan/planning-modes.md +23 -8
  25. package/template/workflows/specdev/P-goal-plan/workspace-execution-template.md +24 -0
  26. package/template/workflows/specdev/common/README.md +2 -2
  27. package/template/workflows/specdev/common/rules/change-completion.md +3 -2
  28. package/template/workflows/specdev/common/rules/path-ownership.md +2 -2
  29. package/template/workflows/specdev/common/schemas/change-status.schema.json +178 -0
  30. package/template/workflows/specdev/common/schemas/goal-plan.schema.json +10 -0
  31. package/template/workflows/specdev/common/skills/dev-worktree/SKILL.md +11 -11
  32. package/template/workflows/specdev/common/skills/dev-worktree/references/create.md +19 -4
  33. package/template/workflows/specdev/common/skills/dev-worktree/references/finalize.md +12 -5
  34. package/template/workflows/specdev/common/skills/subagent-delivery/SKILL.md +4 -3
  35. package/template/workflows/specdev/common/skills/subagent-delivery/references/external-web-subagent.md +1 -1
  36. package/template/workflows/specdev/common/skills/subagent-delivery/references/native-subagent.md +2 -3
  37. package/template/workflows/specdev/common/tools/validate-specdev.mjs +218 -5
package/README.md CHANGED
@@ -50,7 +50,7 @@ After initialization, the target project gains the following AI agent-callable a
50
50
  | `retro` | Retrospective analysis with `gh issue` creation |
51
51
  | `status` | Summary of installed workflows, active changes, and anomalies |
52
52
 
53
- ### 7 Skills
53
+ ### 8 Skills
54
54
 
55
55
  | Skill | Purpose |
56
56
  |---|---|
@@ -58,6 +58,7 @@ After initialization, the target project gains the following AI agent-callable a
58
58
  | `docs-sync` | Documentation audit plus incremental or full AGENTS.md / CLAUDE.md handbook synchronization |
59
59
  | `github-npm-ops` | GitHub issue/PR triage and npm operations |
60
60
  | `migrate-runtime-state` | Validate backups, lock source/target fingerprints, and apply runtime migration plans with rollback |
61
+ | `optimize-codex-config` | Audit and optimize local Codex configuration, custom Responses providers, permissions, and compaction failures |
61
62
  | `speculo-retro` | Retrospective analysis |
62
63
  | `typescript-standards-builder` | Interview-driven generator that produces a project-specific TypeScript/JS/React/Node standards skill |
63
64
  | `writing-great-skills` | Authoring guidance for agent skills |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@namewta/speculo",
3
- "version": "0.7.1",
3
+ "version": "0.7.2",
4
4
  "description": "Workflow-packaged specification-driven development assets with state-safe refresh tooling.",
5
5
  "type": "module",
6
6
  "bin": {
@@ -1926,6 +1926,10 @@ Change CONTEXT/ADR 是 active change 内的执行权威,不是 workflow 级永
1926
1926
  "type": "string",
1927
1927
  "minLength": 1
1928
1928
  },
1929
+ "integration_owner": {
1930
+ "type": "string",
1931
+ "minLength": 1
1932
+ },
1929
1933
  "provider": {
1930
1934
  "enum": [
1931
1935
  "native",
@@ -1937,6 +1941,10 @@ Change CONTEXT/ADR 是 active change 内的执行权威,不是 workflow 级永
1937
1941
  "type": "string",
1938
1942
  "minLength": 1
1939
1943
  },
1944
+ "parent_branch": {
1945
+ "type": "string",
1946
+ "minLength": 1
1947
+ },
1940
1948
  "branch": {
1941
1949
  "type": "string",
1942
1950
  "minLength": 1
@@ -1946,11 +1954,76 @@ Change CONTEXT/ADR 是 active change 内的执行权威,不是 workflow 级永
1946
1954
  "minLength": 1,
1947
1955
  "pattern": "^(?!/)(?![A-Za-z]:[\\\\/]).+"
1948
1956
  },
1957
+ "terminal_action": {
1958
+ "enum": [
1959
+ "integrate",
1960
+ "retain"
1961
+ ]
1962
+ },
1963
+ "source_checkpoint": {
1964
+ "type": [
1965
+ "string",
1966
+ "null"
1967
+ ]
1968
+ },
1969
+ "integration": {
1970
+ "type": "object",
1971
+ "required": [
1972
+ "status",
1973
+ "parent_before_sha",
1974
+ "source_sha",
1975
+ "result_sha",
1976
+ "method",
1977
+ "conflict_paths",
1978
+ "verification",
1979
+ "evidence",
1980
+ "attempts"
1981
+ ],
1982
+ "properties": {
1983
+ "status": {
1984
+ "enum": [
1985
+ "pending",
1986
+ "running",
1987
+ "passed",
1988
+ "blocked"
1989
+ ]
1990
+ },
1991
+ "parent_before_sha": {
1992
+ "type": ["string", "null"]
1993
+ },
1994
+ "source_sha": {
1995
+ "type": ["string", "null"]
1996
+ },
1997
+ "result_sha": {
1998
+ "type": ["string", "null"]
1999
+ },
2000
+ "method": {
2001
+ "enum": [null, "fast-forward", "merge-commit"]
2002
+ },
2003
+ "conflict_paths": {
2004
+ "type": "array",
2005
+ "items": {"type": "string"}
2006
+ },
2007
+ "verification": {
2008
+ "enum": ["pending", "passed", "failed"]
2009
+ },
2010
+ "evidence": {
2011
+ "type": "string",
2012
+ "pattern": "^\\{roots\\.state\\}/specdev/changes/[^<]+/evidence/T-[0-9]{2,}\\.md$"
2013
+ },
2014
+ "attempts": {
2015
+ "type": "integer",
2016
+ "minimum": 0
2017
+ }
2018
+ },
2019
+ "additionalProperties": true
2020
+ },
1949
2021
  "status": {
1950
2022
  "enum": [
1951
2023
  "planned",
1952
2024
  "active",
1953
2025
  "review",
2026
+ "integrating",
1954
2027
  "integrated",
1955
2028
  "removed",
1956
2029
  "blocked"
@@ -1961,6 +2034,111 @@ Change CONTEXT/ADR 是 active change 内的执行权威,不是 workflow 级永
1961
2034
  "minLength": 1
1962
2035
  }
1963
2036
  },
2037
+ "dependentRequired": {
2038
+ "terminal_action": [
2039
+ "integration_owner",
2040
+ "parent_branch",
2041
+ "source_checkpoint",
2042
+ "integration"
2043
+ ]
2044
+ },
2045
+ "allOf": [
2046
+ {
2047
+ "if": {
2048
+ "properties": {
2049
+ "status": {"const": "integrating"}
2050
+ },
2051
+ "required": ["status"]
2052
+ },
2053
+ "then": {
2054
+ "required": [
2055
+ "terminal_action",
2056
+ "integration_owner",
2057
+ "parent_branch",
2058
+ "source_checkpoint",
2059
+ "integration"
2060
+ ],
2061
+ "properties": {
2062
+ "terminal_action": {"const": "integrate"}
2063
+ }
2064
+ }
2065
+ },
2066
+ {
2067
+ "if": {
2068
+ "properties": {
2069
+ "status": {"enum": ["integrating", "integrated"]},
2070
+ "terminal_action": {"const": "integrate"}
2071
+ },
2072
+ "required": ["status", "terminal_action"]
2073
+ },
2074
+ "then": {
2075
+ "properties": {
2076
+ "source_checkpoint": {"type": "string", "minLength": 1},
2077
+ "integration": {
2078
+ "properties": {
2079
+ "parent_before_sha": {"type": "string", "minLength": 1},
2080
+ "source_sha": {"type": "string", "minLength": 1},
2081
+ "attempts": {"type": "integer", "minimum": 1}
2082
+ }
2083
+ }
2084
+ }
2085
+ }
2086
+ },
2087
+ {
2088
+ "if": {
2089
+ "properties": {
2090
+ "status": {"const": "integrating"},
2091
+ "terminal_action": {"const": "integrate"}
2092
+ },
2093
+ "required": ["status", "terminal_action"]
2094
+ },
2095
+ "then": {
2096
+ "properties": {
2097
+ "integration": {
2098
+ "properties": {
2099
+ "status": {"const": "running"}
2100
+ }
2101
+ }
2102
+ }
2103
+ }
2104
+ },
2105
+ {
2106
+ "if": {
2107
+ "properties": {
2108
+ "status": {"const": "integrated"},
2109
+ "terminal_action": {"const": "integrate"}
2110
+ },
2111
+ "required": ["status", "terminal_action"]
2112
+ },
2113
+ "then": {
2114
+ "properties": {
2115
+ "integration": {
2116
+ "properties": {
2117
+ "status": {"const": "passed"},
2118
+ "result_sha": {"type": "string", "minLength": 1},
2119
+ "method": {"enum": ["fast-forward", "merge-commit"]},
2120
+ "verification": {"const": "passed"}
2121
+ }
2122
+ }
2123
+ }
2124
+ }
2125
+ },
2126
+ {
2127
+ "if": {
2128
+ "properties": {
2129
+ "terminal_action": {"const": "retain"}
2130
+ },
2131
+ "required": ["terminal_action"]
2132
+ },
2133
+ "then": {
2134
+ "properties": {
2135
+ "status": {
2136
+ "not": {"enum": ["integrating", "integrated"]}
2137
+ }
2138
+ }
2139
+ }
2140
+ }
2141
+ ],
1964
2142
  "additionalProperties": true
1965
2143
  }
1966
2144
  }