specpilot 2.2.3 → 2.3.0

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 (44) hide show
  1. package/README.md +51 -0
  2. package/dist/cli.js +9 -0
  3. package/dist/cli.js.map +1 -1
  4. package/dist/commands/serve.d.ts +8 -0
  5. package/dist/commands/serve.d.ts.map +1 -0
  6. package/dist/commands/serve.js +66 -0
  7. package/dist/commands/serve.js.map +1 -0
  8. package/dist/utils/markdownSections.d.ts +13 -0
  9. package/dist/utils/markdownSections.d.ts.map +1 -0
  10. package/dist/utils/markdownSections.js +16 -0
  11. package/dist/utils/markdownSections.js.map +1 -0
  12. package/dist/utils/slashCommandGenerator.d.ts.map +1 -1
  13. package/dist/utils/slashCommandGenerator.js +43 -23
  14. package/dist/utils/slashCommandGenerator.js.map +1 -1
  15. package/dist/utils/specArchiver.d.ts +13 -0
  16. package/dist/utils/specArchiver.d.ts.map +1 -1
  17. package/dist/utils/specArchiver.js +57 -33
  18. package/dist/utils/specArchiver.js.map +1 -1
  19. package/dist/utils/specPaths.d.ts +26 -0
  20. package/dist/utils/specPaths.d.ts.map +1 -0
  21. package/dist/utils/specPaths.js +92 -0
  22. package/dist/utils/specPaths.js.map +1 -0
  23. package/dist/utils/specPoller.d.ts +22 -0
  24. package/dist/utils/specPoller.d.ts.map +1 -0
  25. package/dist/utils/specPoller.js +119 -0
  26. package/dist/utils/specPoller.js.map +1 -0
  27. package/dist/utils/specReader.d.ts +30 -0
  28. package/dist/utils/specReader.d.ts.map +1 -0
  29. package/dist/utils/specReader.js +120 -0
  30. package/dist/utils/specReader.js.map +1 -0
  31. package/dist/utils/specServer.d.ts +60 -0
  32. package/dist/utils/specServer.d.ts.map +1 -0
  33. package/dist/utils/specServer.js +259 -0
  34. package/dist/utils/specServer.js.map +1 -0
  35. package/dist/utils/specValidator.d.ts.map +1 -1
  36. package/dist/utils/specValidator.js +5 -13
  37. package/dist/utils/specValidator.js.map +1 -1
  38. package/package.json +11 -4
  39. package/ui/app.css +299 -0
  40. package/ui/app.js +340 -0
  41. package/ui/favicon.svg +25 -0
  42. package/ui/index.html +171 -0
  43. package/ui/md.js +81 -0
  44. package/ui/route.js +25 -0
package/README.md CHANGED
@@ -2,11 +2,39 @@
2
2
 
3
3
  [![npm version](https://img.shields.io/npm/v/specpilot.svg)](https://www.npmjs.com/package/specpilot)
4
4
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
5
+ [![smithery badge](https://smithery.ai/badge/specpilot/specpilot)](https://smithery.ai/servers/specpilot/specpilot)
5
6
 
6
7
  SpecPilot is a spec-driven development (SDD) CLI for AI coding agents like Claude Code, Cursor, and ChatGPT. It initializes, validates, and syncs a `.specs/` directory so AI-assisted coding stays grounded in living requirements, architecture, and task specs instead of drifting from the codebase.
7
8
 
8
9
  ![SpecPilot CLI demo](docs/demo.gif)
9
10
 
11
+ ## MCP server
12
+
13
+ Prefer to stay inside your editor? SpecPilot also runs as a remote MCP server, so
14
+ Claude Code, Cursor or Copilot can run the whole onboarding itself - answering what
15
+ it can infer from your repo and asking you only the rest.
16
+
17
+ ```bash
18
+ claude mcp add --transport http specpilot https://init.specpilot.dev/mcp
19
+ ```
20
+
21
+ Then ask your agent: *"Onboard this project with SpecPilot"*.
22
+
23
+ For Cursor, VS Code and other clients, add it as an HTTP (streamable) server:
24
+
25
+ ```json
26
+ {
27
+ "mcpServers": {
28
+ "specpilot": {
29
+ "type": "http",
30
+ "url": "https://init.specpilot.dev/mcp"
31
+ }
32
+ }
33
+ }
34
+ ```
35
+
36
+ No install, no API key. Full setup notes: <https://specpilot.dev/mcp-setup>
37
+
10
38
  ## Quick Start
11
39
 
12
40
  ```bash
@@ -48,6 +76,7 @@ This AI-assisted approach ensures comprehensive, high-quality specifications tai
48
76
  | `list` | Show available templates |
49
77
  | `migrate` | Convert legacy `.project-spec` folder (rarely needed) |
50
78
  | `refine [desc]` | Refine project specifications |
79
+ | `serve` | Serve a read-only local web UI over the current project's `.specs/` |
51
80
 
52
81
  > **Tip — command aliases:** All commands have a short alias you can use instead of the full name.
53
82
  > `init` → `i` &nbsp;·&nbsp; `validate` → `v` &nbsp;·&nbsp; `migrate` → `m` &nbsp;·&nbsp; `list` → `ls` &nbsp;·&nbsp; `refine` → `ref` &nbsp;·&nbsp; `archive` → `ar` &nbsp;·&nbsp; `add-specs` → `add` &nbsp;·&nbsp; `backfill` → `bf`
@@ -65,6 +94,7 @@ This AI-assisted approach ensures comprehensive, high-quality specifications tai
65
94
  | `archive` | `--dry-run` · `--force` |
66
95
  | `add-specs` | `--no-analysis` · `--deep-analysis` · `--no-prompts` |
67
96
  | `backfill` | `--dir` · `--specs-name` · `--dry-run` · `--no-prompts` |
97
+ | `serve` | `--port` · `--poll` · `--open` |
68
98
 
69
99
  > Run `specpilot <command> --help` for full flag descriptions and default values.
70
100
 
@@ -84,6 +114,27 @@ specpilot refine "REST API for user management" --update
84
114
  specpilot validate --fix
85
115
  ```
86
116
 
117
+ ## specpilot serve
118
+
119
+ Serve a read-only local web UI over the current project's `.specs/`. Run it from the project root (the folder that contains `.specs/`); press Ctrl+C to stop.
120
+
121
+ ```bash
122
+ specpilot serve # http://127.0.0.1:4321
123
+ specpilot serve --port 5000 --open
124
+ ```
125
+
126
+ | Option | Default | Description |
127
+ | ------------- | ------- | ---------------------------------------------------------------------------------------- |
128
+ | `--port <n>` | `4321` | Port to listen on (127.0.0.1 only) |
129
+ | `--poll <ms>` | `1000` | Change-detection interval in ms (minimum 250); polling runs only while a page is open |
130
+ | `--open` | | Open the UI in the default browser |
131
+
132
+ - **Read-only**: re-reads files on every request and writes nothing.
133
+ - **Loopback only**: binds 127.0.0.1 only; rejects any Host header other than `127.0.0.1:<port>` or `localhost:<port>` (403).
134
+ - **Live reload**: polls allowlisted files with `stat()` every `--poll` ms while a page is open, and pushes changed paths on `/api/events`; open pages update in place.
135
+ - **What it shows**: `.specs/`, `CLAUDE.md`, `AGENTS.md`, `.github/copilot-instructions.md`, `.claude/commands/`, `.claude/skills/` and `.github/prompts/`, as the files' own text.
136
+ - **Limits**: paths through symlinked folders, hidden files and `node_modules` are not shown.
137
+
87
138
  ## Supported Languages & Frameworks
88
139
 
89
140
  ### TypeScript
package/dist/cli.js CHANGED
@@ -14,6 +14,7 @@ const refine_1 = require("./commands/refine");
14
14
  const add_specs_1 = require("./commands/add-specs");
15
15
  const archive_1 = require("./commands/archive");
16
16
  const backfill_1 = require("./commands/backfill");
17
+ const serve_1 = require("./commands/serve");
17
18
  const logger_1 = require("./utils/logger");
18
19
  const packageJson = require('../package.json');
19
20
  commander_1.program
@@ -100,6 +101,14 @@ commander_1.program
100
101
  .option('--dry-run', 'Preview changes without writing any files')
101
102
  .option('--no-prompts', 'Accept suggested devPrefix silently when team.devPrefix is missing')
102
103
  .action(backfill_1.backfillCommand);
104
+ // Serve command
105
+ commander_1.program
106
+ .command('serve')
107
+ .description('Serve a read-only local web UI over this project\'s .specs/ (127.0.0.1 only)')
108
+ .option('-p, --port <number>', 'Port to listen on', '4321')
109
+ .option('--poll <ms>', 'How often to check spec files for changes, in ms (minimum 250)', '1000')
110
+ .option('--open', 'Open the UI in your default browser')
111
+ .action(serve_1.serveCommand);
103
112
  commander_1.program.addHelpText('after', `
104
113
  Aliases:
105
114
  init → i validate → v migrate → m list → ls
package/dist/cli.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ export interface ServeOptions {
2
+ port?: string;
3
+ poll?: string;
4
+ open?: boolean;
5
+ }
6
+ /** Runs until Ctrl+C; exits the process with 1 on any startup error. */
7
+ export declare function serveCommand(options: ServeOptions): Promise<void>;
8
+ //# sourceMappingURL=serve.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAiBD,wEAAwE;AACxE,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAyCvE"}
@@ -0,0 +1,66 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.serveCommand = serveCommand;
7
+ const chalk_1 = __importDefault(require("chalk"));
8
+ const child_process_1 = require("child_process");
9
+ const fs_1 = require("fs");
10
+ const path_1 = require("path");
11
+ const specServer_1 = require("../utils/specServer");
12
+ const logger_1 = require("../utils/logger");
13
+ const packageJson = require('../../package.json');
14
+ const DEFAULT_PORT = 4321;
15
+ const DEFAULT_POLL_MS = 1000;
16
+ const MIN_POLL_MS = 250;
17
+ /** Open `url` in the default browser. The URL is built here, never taken from input. */
18
+ function openBrowser(url, logger) {
19
+ const [cmd, args] = process.platform === 'darwin' ? ['open', [url]]
20
+ : process.platform === 'win32' ? ['cmd', ['/c', 'start', '', url]]
21
+ : ['xdg-open', [url]];
22
+ const child = (0, child_process_1.spawn)(cmd, args, { stdio: 'ignore', detached: true });
23
+ child.on('error', () => logger.warn(`Could not open a browser. Open ${url} yourself.`));
24
+ child.unref();
25
+ }
26
+ /** Runs until Ctrl+C; exits the process with 1 on any startup error. */
27
+ async function serveCommand(options) {
28
+ const logger = new logger_1.Logger();
29
+ const root = process.cwd();
30
+ if (!(0, fs_1.existsSync)((0, path_1.join)(root, '.specs'))) {
31
+ logger.error('No .specs/ folder in this directory. Run `specpilot serve` from a project root, or `specpilot init` first.');
32
+ return process.exit(1);
33
+ }
34
+ const port = options.port === undefined ? DEFAULT_PORT : Number(options.port);
35
+ if (!Number.isInteger(port) || port < 1 || port > 65535) {
36
+ logger.error(`Invalid --port "${options.port}". Use a whole number from 1 to 65535.`);
37
+ return process.exit(1);
38
+ }
39
+ const pollMs = options.poll === undefined ? DEFAULT_POLL_MS : Number(options.poll);
40
+ if (!Number.isInteger(pollMs) || pollMs < MIN_POLL_MS) {
41
+ logger.error(`Invalid --poll "${options.poll}". Use a whole number of milliseconds, ${MIN_POLL_MS} or more.`);
42
+ return process.exit(1);
43
+ }
44
+ let handle;
45
+ try {
46
+ handle = await (0, specServer_1.startSpecServer)(root, port, packageJson.version, { pollMs, log: m => logger.warn(m) });
47
+ }
48
+ catch (err) {
49
+ if (err.code === 'EADDRINUSE') {
50
+ logger.error(`Port ${port} is already in use. Pick another with --port, e.g. \`specpilot serve --port ${port === 65535 ? 4322 : port + 1}\`.`);
51
+ }
52
+ else {
53
+ logger.error(`Could not start the server: ${err.message}`);
54
+ }
55
+ return process.exit(1);
56
+ }
57
+ const url = `http://127.0.0.1:${port}`;
58
+ console.log(chalk_1.default.green(`SpecPilot is serving ${root} read-only at ${url}`));
59
+ console.log(chalk_1.default.gray('Open pages update when a spec file changes. Press Ctrl+C to stop.'));
60
+ if (options.open)
61
+ openBrowser(url, logger);
62
+ process.once('SIGINT', () => {
63
+ void handle.close().then(() => process.exit(0));
64
+ });
65
+ }
66
+ //# sourceMappingURL=serve.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"serve.js","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":";;;;;AA+BA,oCAyCC;AAxED,kDAA0B;AAC1B,iDAAsC;AACtC,2BAAgC;AAChC,+BAA4B;AAC5B,oDAAkE;AAClE,4CAAyC;AAEzC,MAAM,WAAW,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAQlD,MAAM,YAAY,GAAG,IAAI,CAAC;AAC1B,MAAM,eAAe,GAAG,IAAI,CAAC;AAC7B,MAAM,WAAW,GAAG,GAAG,CAAC;AAExB,wFAAwF;AACxF,SAAS,WAAW,CAAC,GAAW,EAAE,MAAc;IAC9C,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,GACf,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;QAC/C,CAAC,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;YAClE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,MAAM,KAAK,GAAG,IAAA,qBAAK,EAAC,GAAG,EAAE,IAAgB,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAChF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,kCAAkC,GAAG,YAAY,CAAC,CAAC,CAAC;IACxF,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC;AAED,wEAAwE;AACjE,KAAK,UAAU,YAAY,CAAC,OAAqB;IACtD,MAAM,MAAM,GAAG,IAAI,eAAM,EAAE,CAAC;IAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAE3B,IAAI,CAAC,IAAA,eAAU,EAAC,IAAA,WAAI,EAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,4GAA4G,CAAC,CAAC;QAC3H,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;QACxD,MAAM,CAAC,KAAK,CAAC,mBAAmB,OAAO,CAAC,IAAI,wCAAwC,CAAC,CAAC;QACtF,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnF,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,WAAW,EAAE,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,mBAAmB,OAAO,CAAC,IAAI,0CAA0C,WAAW,WAAW,CAAC,CAAC;QAC9G,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;IAED,IAAI,MAAkB,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,IAAA,4BAAe,EAAC,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACxG,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YACzD,MAAM,CAAC,KAAK,CAAC,QAAQ,IAAI,+EAA+E,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;QACjJ,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,KAAK,CAAC,+BAAgC,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;IAED,MAAM,GAAG,GAAG,oBAAoB,IAAI,EAAE,CAAC;IACvC,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,wBAAwB,IAAI,iBAAiB,GAAG,EAAE,CAAC,CAAC,CAAC;IAC7E,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,mEAAmE,CAAC,CAAC,CAAC;IAC7F,IAAI,OAAO,CAAC,IAAI;QAAE,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAE3C,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE;QAC1B,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC"}
@@ -0,0 +1,13 @@
1
+ export interface SectionBounds {
2
+ /** Index of the heading line. */
3
+ start: number;
4
+ /** Index of the next `## ` heading, or `lines.length` — a section ends there, not at EOF. */
5
+ end: number;
6
+ }
7
+ /**
8
+ * Locate a `## ` section. The heading is matched against each line's trimmed text:
9
+ * exactly by default, or as a prefix when `prefix` is true (for headings that carry
10
+ * an ID suffix, e.g. `## Latest Entries [PROMPT-002]`). Returns null when absent.
11
+ */
12
+ export declare function findSectionBounds(lines: string[], heading: string, prefix?: boolean): SectionBounds | null;
13
+ //# sourceMappingURL=markdownSections.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"markdownSections.d.ts","sourceRoot":"","sources":["../../src/utils/markdownSections.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,6FAA6F;IAC7F,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,aAAa,GAAG,IAAI,CAKxG"}
@@ -0,0 +1,16 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.findSectionBounds = findSectionBounds;
4
+ /**
5
+ * Locate a `## ` section. The heading is matched against each line's trimmed text:
6
+ * exactly by default, or as a prefix when `prefix` is true (for headings that carry
7
+ * an ID suffix, e.g. `## Latest Entries [PROMPT-002]`). Returns null when absent.
8
+ */
9
+ function findSectionBounds(lines, heading, prefix = false) {
10
+ const start = lines.findIndex(l => (prefix ? l.trim().startsWith(heading) : l.trim() === heading));
11
+ if (start === -1)
12
+ return null;
13
+ const next = lines.findIndex((l, i) => i > start && /^## /.test(l.trim()));
14
+ return { start, end: next === -1 ? lines.length : next };
15
+ }
16
+ //# sourceMappingURL=markdownSections.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"markdownSections.js","sourceRoot":"","sources":["../../src/utils/markdownSections.ts"],"names":[],"mappings":";;AAYA,8CAKC;AAVD;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,KAAe,EAAE,OAAe,EAAE,MAAM,GAAG,KAAK;IAChF,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC;IACnG,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3E,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC3D,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"slashCommandGenerator.d.ts","sourceRoot":"","sources":["../../src/utils/slashCommandGenerator.ts"],"names":[],"mappings":"AAGA,0EAA0E;AAC1E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,YAAY,EAyWxC,CAAC;AAEF;;;;GAIG;AACH,qBAAa,qBAAqB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,GAAE,YAAY,EAAmB,GAAG,IAAI;IAkB1F;;;;OAIG;IACH,eAAe,CACb,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,OAAO,EACf,QAAQ,GAAE,YAAY,EAAmB,GACxC,MAAM,EAAE;IAeX,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,KAAK;IAMb,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,kBAAkB;CAG3B"}
1
+ {"version":3,"file":"slashCommandGenerator.d.ts","sourceRoot":"","sources":["../../src/utils/slashCommandGenerator.ts"],"names":[],"mappings":"AAGA,0EAA0E;AAC1E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,YAAY,EA6XxC,CAAC;AAEF;;;;GAIG;AACH,qBAAa,qBAAqB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,GAAE,YAAY,EAAmB,GAAG,IAAI;IAkB1F;;;;OAIG;IACH,eAAe,CACb,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,OAAO,EACf,QAAQ,GAAE,YAAY,EAAmB,GACxC,MAAM,EAAE;IAeX,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,KAAK;IAMb,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,kBAAkB;CAG3B"}
@@ -212,31 +212,51 @@ archive_tasks() {
212
212
  local file=".specs/planning/tasks.md"
213
213
  local archive=".specs/planning/tasks-archive.md"
214
214
  [ -f "$file" ] || return 0
215
- local total
216
- total=$(wc -l < "$file")
217
- local completed_line
218
- completed_line=$(grep -n '^## Completed$' "$file" | head -1 | cut -d: -f1)
219
- [ -n "$completed_line" ] || return 0
220
-
221
- local section_size=$((total - completed_line + 1))
222
- if [ "$section_size" -le "$COMPLETED_LINE_LIMIT" ]; then return 0; fi
223
-
224
- local entry_start=$((completed_line + 1))
225
- while [ "$entry_start" -le "$total" ] && ! sed -n "\${entry_start}p" "$file" | grep -qE '^[0-9]+\\.'; do
226
- entry_start=$((entry_start + 1))
227
- done
228
- if [ "$entry_start" -gt "$total" ]; then return 0; fi
229
-
230
- local entry_count=$((total - entry_start + 1))
231
- if [ "$entry_count" -le "$COMPLETED_KEEP_ENTRIES" ]; then return 0; fi
232
-
233
- local archive_count=$((entry_count - COMPLETED_KEEP_ENTRIES))
234
- local archive_end=$((entry_start + archive_count - 1))
235
215
 
236
- { echo "## Archived on $(timestamp)"; echo; sed -n "\${entry_start},\${archive_end}p" "$file"; echo; echo "---"; echo; } >> "$archive"
237
- { sed -n "1,$((entry_start - 1))p" "$file"; sed -n "$((archive_end + 1)),\\$p" "$file"; } > "$file.tmp"
216
+ # Mirrors the CLI's planCompletedArchive() line for line. The section runs from
217
+ # "## Completed" to the next "## " heading, not EOF. Sizes use the CLI's arithmetic,
218
+ # which counts one more line than wc -l at EOF, so the EOF section end is total + 2.
219
+ # Entries are numbered-list lines, or else the body rows of a table (header and
220
+ # separator stay put); a table keeps only as many rows as fit the line limit.
221
+ # Prints "<shape> <first> <last> <header>" as 1-based lines to move, or nothing.
222
+ local plan
223
+ plan=$(awk -v total="$(wc -l < "$file")" -v limit="$COMPLETED_LINE_LIMIT" -v keep_max="$COMPLETED_KEEP_ENTRIES" '
224
+ { line[NR] = $0; t = $0; gsub(/^[ \\t]+|[ \\t]+$/, "", t); trimmed[NR] = t }
225
+ END {
226
+ for (i = 1; i <= NR; i++) if (trimmed[i] == "## Completed") { start = i; break }
227
+ if (!start) exit
228
+ end_ = total + 2
229
+ for (i = start + 1; i <= NR; i++) if (trimmed[i] ~ /^## /) { end_ = i; break }
230
+ size = end_ - start
231
+ if (size <= limit) exit
232
+ for (i = start + 1; i < end_; i++) if (line[i] ~ /^[0-9]+\\./) {
233
+ if (end_ - i <= keep_max) exit
234
+ print "list", i, end_ - keep_max - 1, 0
235
+ exit
236
+ }
237
+ for (i = start + 1; i < end_ - 1; i++) if (trimmed[i] ~ /^\\|/ && trimmed[i + 1] ~ /^\\|[ \\t:|-]+$/) {
238
+ body = i + 2; stop = body
239
+ while (stop < end_ && trimmed[stop] ~ /^\\|/) stop++
240
+ rows = stop - body
241
+ keep = limit - (size - rows); if (keep < 0) keep = 0; if (keep > keep_max) keep = keep_max
242
+ if (rows <= keep) exit
243
+ print "table", body, stop - keep - 1, i
244
+ exit
245
+ }
246
+ }' "$file")
247
+ [ -n "$plan" ] || return 0
248
+ local shape first last header
249
+ read -r shape first last header <<< "$plan"
250
+
251
+ {
252
+ echo "## Archived on $(timestamp)"; echo
253
+ if [ "$shape" = "table" ]; then sed -n "\${header},$((header + 1))p" "$file"; fi
254
+ sed -n "\${first},\${last}p" "$file"
255
+ echo; echo "---"; echo
256
+ } >> "$archive"
257
+ { sed -n "1,$((first - 1))p" "$file"; sed -n "$((last + 1)),\\$p" "$file"; } > "$file.tmp"
238
258
  mv "$file.tmp" "$file"
239
- echo "Moved $archive_count entries from $file -> $archive"
259
+ echo "Moved $((last - first + 1)) entries from $file -> $archive"
240
260
  }
241
261
 
242
262
  archive_prompts
@@ -1 +1 @@
1
- {"version":3,"file":"slashCommandGenerator.js","sourceRoot":"","sources":["../../src/utils/slashCommandGenerator.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"slashCommandGenerator.js","sourceRoot":"","sources":["../../src/utils/slashCommandGenerator.ts"],"names":[],"mappings":"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"}
@@ -7,6 +7,19 @@ export interface ArchiveResult {
7
7
  entries: ArchiveEntry[];
8
8
  dryRun: boolean;
9
9
  }
10
+ export interface CompletedArchivePlan {
11
+ /** Line indices [start, end) moved out of tasks.md. */
12
+ start: number;
13
+ end: number;
14
+ /** Table header + separator, repeated above the moved rows in the archive; empty for lists. */
15
+ tableHeader: string[];
16
+ }
17
+ /**
18
+ * Decide what `specpilot archive` moves out of tasks.md's `## Completed` section, or null
19
+ * if nothing. The validator warns exactly when this returns non-null, so "validate warns"
20
+ * and "archive acts" can never disagree.
21
+ */
22
+ export declare function planCompletedArchive(lines: string[]): CompletedArchivePlan | null;
10
23
  export declare class SpecArchiver {
11
24
  private findSpecsDir;
12
25
  archive(projectDir: string, options: {
@@ -1 +1 @@
1
- {"version":3,"file":"specArchiver.d.ts","sourceRoot":"","sources":["../../src/utils/specArchiver.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;CACjB;AAaD,qBAAa,YAAY;IACvB,OAAO,CAAC,YAAY;IAQd,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAiBvF,OAAO,CAAC,qBAAqB;IAK7B,OAAO,CAAC,cAAc;IA2CtB,OAAO,CAAC,YAAY;CAqDrB"}
1
+ {"version":3,"file":"specArchiver.d.ts","sourceRoot":"","sources":["../../src/utils/specArchiver.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;CACjB;AAaD,MAAM,WAAW,oBAAoB;IACnC,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,+FAA+F;IAC/F,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAID;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,oBAAoB,GAAG,IAAI,CAgCjF;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,YAAY;IAQd,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAiBvF,OAAO,CAAC,qBAAqB;IAK7B,OAAO,CAAC,cAAc;IA2CtB,OAAO,CAAC,YAAY;CA6BrB"}
@@ -1,8 +1,10 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.SpecArchiver = void 0;
4
+ exports.planCompletedArchive = planCompletedArchive;
4
5
  const fs_1 = require("fs");
5
6
  const path_1 = require("path");
7
+ const markdownSections_1 = require("./markdownSections");
6
8
  const SPECS_DIR_CANDIDATES = ['.specs', '.project-spec', 'specs', 'specifications'];
7
9
  /** Trim prompts.md to this many total lines after archiving. */
8
10
  const PROMPTS_LINE_LIMIT = 100;
@@ -11,6 +13,48 @@ const PROMPTS_KEEP_LINES = 80;
11
13
  const COMPLETED_LINE_LIMIT = 25;
12
14
  /** How many Completed entries to retain in the active file. */
13
15
  const COMPLETED_KEEP_ENTRIES = 20;
16
+ const TABLE_SEPARATOR = /^\|[\s:|-]+$/;
17
+ /**
18
+ * Decide what `specpilot archive` moves out of tasks.md's `## Completed` section, or null
19
+ * if nothing. The validator warns exactly when this returns non-null, so "validate warns"
20
+ * and "archive acts" can never disagree.
21
+ */
22
+ function planCompletedArchive(lines) {
23
+ // The Completed section ends at the next `## ` heading, not at EOF — anything
24
+ // after it (e.g. `## Multi-Dev Notes`) is a separate section and must survive.
25
+ const bounds = (0, markdownSections_1.findSectionBounds)(lines, '## Completed');
26
+ if (!bounds)
27
+ return null;
28
+ const { start, end } = bounds;
29
+ const sectionSize = end - start;
30
+ if (sectionSize <= COMPLETED_LINE_LIMIT)
31
+ return null;
32
+ // List shape: skip past the heading and any notes/blank lines to the first numbered entry,
33
+ // then keep the last COMPLETED_KEEP_ENTRIES lines (oldest entries are at the top).
34
+ let entryStart = start + 1;
35
+ while (entryStart < end && !/^\d+\./.test(lines[entryStart]))
36
+ entryStart++;
37
+ if (entryStart < end) {
38
+ const entryCount = end - entryStart;
39
+ if (entryCount <= COMPLETED_KEEP_ENTRIES)
40
+ return null;
41
+ return { start: entryStart, end: entryStart + entryCount - COMPLETED_KEEP_ENTRIES, tableHeader: [] };
42
+ }
43
+ // Table shape: entries are the body rows under the header + separator, oldest first.
44
+ // Keep only as many rows as fit the line limit, so the section passes validation afterwards.
45
+ const header = lines.findIndex((l, i) => i > start && i < end - 1 && l.trim().startsWith('|') && TABLE_SEPARATOR.test(lines[i + 1].trim()));
46
+ if (header === -1)
47
+ return null;
48
+ const bodyStart = header + 2;
49
+ let bodyEnd = bodyStart;
50
+ while (bodyEnd < end && lines[bodyEnd].trim().startsWith('|'))
51
+ bodyEnd++;
52
+ const rows = bodyEnd - bodyStart;
53
+ const keep = Math.min(COMPLETED_KEEP_ENTRIES, Math.max(0, COMPLETED_LINE_LIMIT - (sectionSize - rows)));
54
+ if (rows <= keep)
55
+ return null;
56
+ return { start: bodyStart, end: bodyStart + rows - keep, tableHeader: [lines[header], lines[header + 1]] };
57
+ }
14
58
  class SpecArchiver {
15
59
  findSpecsDir(projectDir) {
16
60
  for (const name of SPECS_DIR_CANDIDATES) {
@@ -34,9 +78,9 @@ class SpecArchiver {
34
78
  result.entries.push(tasksEntry);
35
79
  return result;
36
80
  }
37
- buildTimestampedBlock(content) {
81
+ buildTimestampedBlock(content, trim = true) {
38
82
  const now = new Date().toISOString().replace('T', ' ').slice(0, 19);
39
- return `## Archived on ${now}\n\n${content.trimEnd()}\n\n---\n\n`;
83
+ return `## Archived on ${now}\n\n${trim ? content.trimEnd() : content}\n\n---\n\n`;
40
84
  }
41
85
  archivePrompts(specsDir, dryRun) {
42
86
  const filePath = (0, path_1.join)(specsDir, 'development', 'prompts.md');
@@ -49,7 +93,7 @@ class SpecArchiver {
49
93
  // Anchor on the "## Latest Entries" heading (falls back to front matter close,
50
94
  // then start of file) so boilerplate sections — Re-Anchor Prompt, etc. — are
51
95
  // never mistaken for archivable log content.
52
- let entryStartIdx = allLines.findIndex(l => l.trim().startsWith('## Latest Entries'));
96
+ let entryStartIdx = (0, markdownSections_1.findSectionBounds)(allLines, '## Latest Entries', true)?.start ?? -1;
53
97
  if (entryStartIdx === -1) {
54
98
  entryStartIdx = allLines[0]?.trim() === '---' ? allLines.findIndex((l, i) => i > 0 && l.trim() === '---') : -1;
55
99
  }
@@ -79,41 +123,21 @@ class SpecArchiver {
79
123
  const filePath = (0, path_1.join)(specsDir, 'planning', 'tasks.md');
80
124
  if (!(0, fs_1.existsSync)(filePath))
81
125
  return null;
82
- const content = (0, fs_1.readFileSync)(filePath, 'utf-8');
83
- const allLines = content.split('\n');
84
- const completedIdx = allLines.findIndex(l => l.trim() === '## Completed');
85
- if (completedIdx === -1)
86
- return null;
87
- // The Completed section ends at the next `## ` heading, not at EOF — anything
88
- // after it (e.g. `## Multi-Dev Notes`) is a separate section and must survive.
89
- let sectionEndIdx = allLines.findIndex((l, i) => i > completedIdx && /^## /.test(l.trim()));
90
- if (sectionEndIdx === -1)
91
- sectionEndIdx = allLines.length;
92
- const trailingLines = allLines.slice(sectionEndIdx);
93
- // Section size consistent with specValidator's check — measured to the section
94
- // end, not EOF, so trailing sections never inflate it.
95
- const sectionSize = sectionEndIdx - completedIdx;
96
- if (sectionSize <= COMPLETED_LINE_LIMIT)
97
- return null;
98
- // Skip past the ## Completed heading and any notes/blank lines to find numbered entries
99
- let entryStartIdx = completedIdx + 1;
100
- while (entryStartIdx < sectionEndIdx && !/^\d+\./.test(allLines[entryStartIdx])) {
101
- entryStartIdx++;
102
- }
103
- if (entryStartIdx >= sectionEndIdx)
104
- return null;
105
- const entryLines = allLines.slice(entryStartIdx, sectionEndIdx);
106
- if (entryLines.length <= COMPLETED_KEEP_ENTRIES)
126
+ const allLines = (0, fs_1.readFileSync)(filePath, 'utf-8').split('\n');
127
+ const plan = planCompletedArchive(allLines);
128
+ if (!plan)
107
129
  return null;
108
- const archiveEntries = entryLines.slice(0, entryLines.length - COMPLETED_KEEP_ENTRIES);
109
- const keepEntries = entryLines.slice(entryLines.length - COMPLETED_KEEP_ENTRIES);
110
- const linesMoved = archiveEntries.length;
130
+ const moved = allLines.slice(plan.start, plan.end);
131
+ const linesMoved = moved.length;
111
132
  const archivePath = (0, path_1.join)(specsDir, 'planning', 'tasks-archive.md');
112
- const block = this.buildTimestampedBlock(archiveEntries.join('\n'));
133
+ // Table rows move byte for byte, so the table block is not trimmed.
134
+ const block = plan.tableHeader.length
135
+ ? this.buildTimestampedBlock([...plan.tableHeader, ...moved].join('\n'), false)
136
+ : this.buildTimestampedBlock(moved.join('\n'));
113
137
  if (!dryRun) {
114
138
  const existing = (0, fs_1.existsSync)(archivePath) ? (0, fs_1.readFileSync)(archivePath, 'utf-8') : '';
115
139
  (0, fs_1.writeFileSync)(archivePath, existing + block);
116
- (0, fs_1.writeFileSync)(filePath, [...allLines.slice(0, entryStartIdx), ...keepEntries, ...trailingLines].join('\n'));
140
+ (0, fs_1.writeFileSync)(filePath, [...allLines.slice(0, plan.start), ...allLines.slice(plan.end)].join('\n'));
117
141
  }
118
142
  return {
119
143
  file: 'planning/tasks.md',
@@ -1 +1 @@
1
- {"version":3,"file":"specArchiver.js","sourceRoot":"","sources":["../../src/utils/specArchiver.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"specArchiver.js","sourceRoot":"","sources":["../../src/utils/specArchiver.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,26 @@
1
+ export declare const ALLOWED_FILES: string[];
2
+ export declare const ALLOWED_DIRS: string[];
3
+ /** Upper bound on files one scan returns, so a huge tree cannot make each poll expensive. */
4
+ export declare const MAX_SCAN_FILES = 2000;
5
+ /**
6
+ * Map a requested project-relative path to a real file the server may read, or null.
7
+ * Rejects NUL, backslashes, absolute paths and `..` segments; no folder on the way may be a
8
+ * symlink (the scanner does not follow them either); after resolving a symlinked file the
9
+ * target must still be inside the project root and still inside the allowlist.
10
+ */
11
+ export declare function resolveAllowedPath(root: string, requested: string): string | null;
12
+ export interface AllowedScan {
13
+ /** Project-relative, `/`-joined paths in walk order: the allowlisted files, then each folder sorted. */
14
+ files: string[];
15
+ /** Folders that exist but could not be listed (EACCES, EPERM): their contents are unknown, not gone. */
16
+ unreadable: string[];
17
+ /** True when the scan stopped at `max` files. */
18
+ capped: boolean;
19
+ }
20
+ /**
21
+ * Every path a request may name: the allowlisted files, plus every non-hidden file under the
22
+ * allowlisted folders, skipping `node_modules` and dot-folders such as `.git`. Stops at `max`.
23
+ * Only directory listings are read here, never file content, and nothing here throws.
24
+ */
25
+ export declare function listAllowedFiles(root: string, max?: number): AllowedScan;
26
+ //# sourceMappingURL=specPaths.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"specPaths.d.ts","sourceRoot":"","sources":["../../src/utils/specPaths.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,aAAa,UAAgE,CAAC;AAC3F,eAAO,MAAM,YAAY,UAA0E,CAAC;AAEpG,6FAA6F;AAC7F,eAAO,MAAM,cAAc,OAAO,CAAC;AAYnC;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiBjF;AAED,MAAM,WAAW,WAAW;IAC1B,wGAAwG;IACxG,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,wGAAwG;IACxG,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,iDAAiD;IACjD,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAiB,GAAG,WAAW,CAsBhF"}