@agent-ix/quoin 0.5.4 → 0.6.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.
- package/.codex-plugin/plugin.json +18 -1
- package/README.md +44 -4
- package/bin/quoin.js +11 -5
- package/dist/base-B_MXqS0S.js +137 -0
- package/dist/base.d.ts +23 -0
- package/dist/base.d.ts.map +1 -0
- package/dist/cli.d.ts +17 -3
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +20 -2
- package/dist/commands/catalog/index.d.ts +2 -0
- package/dist/commands/catalog/index.d.ts.map +1 -0
- package/dist/commands/catalog/index.js +2 -0
- package/dist/commands/catalog/list.d.ts +11 -0
- package/dist/commands/catalog/list.d.ts.map +1 -0
- package/dist/commands/catalog/list.js +22 -0
- package/dist/commands/catalog/show.d.ts +13 -0
- package/dist/commands/catalog/show.d.ts.map +1 -0
- package/dist/commands/catalog/show.js +25 -0
- package/dist/commands/catalog/validate.d.ts +10 -0
- package/dist/commands/catalog/validate.d.ts.map +1 -0
- package/dist/commands/catalog/validate.js +27 -0
- package/dist/commands/config/doctor.d.ts +7 -0
- package/dist/commands/config/doctor.d.ts.map +1 -0
- package/dist/commands/config/doctor.js +15 -0
- package/dist/commands/config/edit.d.ts +7 -0
- package/dist/commands/config/edit.d.ts.map +1 -0
- package/dist/commands/config/edit.js +13 -0
- package/dist/commands/config/get.d.ts +11 -0
- package/dist/commands/config/get.d.ts.map +1 -0
- package/dist/commands/config/get.js +20 -0
- package/dist/commands/config/index.d.ts +2 -0
- package/dist/commands/config/index.d.ts.map +1 -0
- package/dist/commands/config/index.js +2 -0
- package/dist/commands/config/set.d.ts +12 -0
- package/dist/commands/config/set.d.ts.map +1 -0
- package/dist/commands/config/set.js +26 -0
- package/dist/commands/matrix.d.ts +14 -0
- package/dist/commands/matrix.d.ts.map +1 -0
- package/dist/commands/matrix.js +15 -0
- package/dist/commands/module/ensure-defaults.d.ts +8 -0
- package/dist/commands/module/ensure-defaults.d.ts.map +1 -0
- package/dist/commands/module/ensure-defaults.js +17 -0
- package/dist/commands/module/index.d.ts +2 -0
- package/dist/commands/module/index.d.ts.map +1 -0
- package/dist/commands/module/index.js +2 -0
- package/dist/commands/module/install.d.ts +11 -0
- package/dist/commands/module/install.d.ts.map +1 -0
- package/dist/commands/module/install.js +22 -0
- package/dist/commands/module/list.d.ts +8 -0
- package/dist/commands/module/list.d.ts.map +1 -0
- package/dist/commands/module/list.js +13 -0
- package/dist/commands/module/remove.d.ts +10 -0
- package/dist/commands/module/remove.d.ts.map +1 -0
- package/dist/commands/module/remove.js +16 -0
- package/dist/commands/plugin/deprecation.d.ts +10 -0
- package/dist/commands/plugin/deprecation.d.ts.map +1 -0
- package/dist/commands/plugin/ensure-defaults.d.ts +8 -0
- package/dist/commands/plugin/ensure-defaults.d.ts.map +1 -0
- package/dist/commands/plugin/ensure-defaults.js +12 -0
- package/dist/commands/plugin/index.d.ts +2 -0
- package/dist/commands/plugin/index.d.ts.map +1 -0
- package/dist/commands/plugin/index.js +2 -0
- package/dist/commands/plugin/install.d.ts +8 -0
- package/dist/commands/plugin/install.d.ts.map +1 -0
- package/dist/commands/plugin/install.js +12 -0
- package/dist/commands/plugin/list.d.ts +8 -0
- package/dist/commands/plugin/list.d.ts.map +1 -0
- package/dist/commands/plugin/list.js +12 -0
- package/dist/commands/plugin/remove.d.ts +8 -0
- package/dist/commands/plugin/remove.d.ts.map +1 -0
- package/dist/commands/plugin/remove.js +12 -0
- package/dist/commands/review.d.ts +14 -0
- package/dist/commands/review.d.ts.map +1 -0
- package/dist/commands/review.js +15 -0
- package/dist/commands/to-plan.d.ts +14 -0
- package/dist/commands/to-plan.d.ts.map +1 -0
- package/dist/commands/to-plan.js +15 -0
- package/dist/commands/update.d.ts +13 -0
- package/dist/commands/update.d.ts.map +1 -0
- package/dist/commands/update.js +34 -0
- package/dist/commands/write.d.ts +16 -0
- package/dist/commands/write.d.ts.map +1 -0
- package/dist/commands/write.js +33 -0
- package/dist/config-schema-Dp-vlxuR.js +13 -0
- package/dist/config-schema.d.ts +52 -0
- package/dist/config-schema.d.ts.map +1 -0
- package/dist/deprecation-fRxUHoxv.js +4 -0
- package/dist/flow-command-DTPkcpHy.js +88 -0
- package/dist/flow-command.d.ts +25 -0
- package/dist/flow-command.d.ts.map +1 -0
- package/dist/index.d.ts +6 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +9 -2
- package/dist/modules-BcFs6dmB.js +22 -0
- package/dist/org.d.ts +61 -0
- package/dist/org.d.ts.map +1 -0
- package/dist/plugins-ica0OxAT.js +77 -0
- package/dist/version-BF9oqMYd.js +17 -0
- package/dist/version.d.ts +3 -0
- package/dist/version.d.ts.map +1 -0
- package/dist/write-CLwhJDM2.js +156 -0
- package/dist/write.d.ts +7 -1
- package/dist/write.d.ts.map +1 -1
- package/package.json +34 -3
- package/skills/spec-to-plan/SKILL.md +5 -2
- package/skills/spec-to-plan/references/step-1-analysis.md +10 -0
- package/skills/spec-to-plan/references/step-2-test-plan.md +4 -0
- package/skills/spec-to-plan/references/step-3-execution-plan.md +36 -23
- package/skills/specify/SKILL.md +5 -0
- package/skills/specify/assets/app-spec-template.md +1 -1
- package/skills/specify/assets/spec-template.md +1 -1
- package/dist/cli-Dk-aYzJo.js +0 -461
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import { QuoinCommand } from './base.js';
|
|
2
|
+
/**
|
|
3
|
+
* Base for the bundled spec-workflow launchers (`review`, `matrix`, `to-plan`).
|
|
4
|
+
*
|
|
5
|
+
* quoin creates the workflow run in ~/.ix/flows by spawning `ix-flow` (see
|
|
6
|
+
* {@link startSpecFlow}); ix-flow then inspects, resumes, advances phases, and
|
|
7
|
+
* acknowledges human gates. The subprocess delegation is unchanged from the
|
|
8
|
+
* legacy dispatcher — the launcher only translates flags into the ix-flow argv.
|
|
9
|
+
*/
|
|
10
|
+
export declare abstract class FlowCommand extends QuoinCommand {
|
|
11
|
+
/** Flags shared by every flow launcher; concrete commands reuse this set. */
|
|
12
|
+
static flowFlags: {
|
|
13
|
+
target: import('@oclif/core/interfaces').OptionFlag<string[] | undefined, import('@oclif/core/interfaces').CustomOptions>;
|
|
14
|
+
json: import('@oclif/core/interfaces').BooleanFlag<boolean>;
|
|
15
|
+
id: import('@oclif/core/interfaces').OptionFlag<string | undefined, import('@oclif/core/interfaces').CustomOptions>;
|
|
16
|
+
};
|
|
17
|
+
/** ix-flow workflow name; equals the command id (review/matrix/to-plan). */
|
|
18
|
+
protected abstract readonly flowName: string;
|
|
19
|
+
protected launch(flags: {
|
|
20
|
+
target?: string[];
|
|
21
|
+
json?: boolean;
|
|
22
|
+
id?: string;
|
|
23
|
+
}): Promise<void>;
|
|
24
|
+
}
|
|
25
|
+
//# sourceMappingURL=flow-command.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"flow-command.d.ts","sourceRoot":"","sources":["../src/flow-command.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGzC;;;;;;;GAOG;AACH,8BAAsB,WAAY,SAAQ,YAAY;IACpD,6EAA6E;IAC7E,MAAM,CAAC,SAAS;;;;MAOd;IAEF,4EAA4E;IAC5E,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;cAE7B,MAAM,CAAC,KAAK,EAAE;QAC5B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,EAAE,CAAC,EAAE,MAAM,CAAC;KACb,GAAG,OAAO,CAAC,IAAI,CAAC;CAOlB"}
|
package/dist/index.d.ts
CHANGED
|
@@ -1,6 +1,11 @@
|
|
|
1
|
-
export { main } from './cli.js';
|
|
1
|
+
export { main, isVersionRequest } from './cli.js';
|
|
2
|
+
export { packageVersion, resolveVersion } from './version.js';
|
|
2
3
|
export { loadCatalog, defaultModuleRoots, filamentModulesDir, findCatalogEntry, } from './catalog.js';
|
|
3
4
|
export { ensureDefaultModules, defaultModulesManifest } from './modules.js';
|
|
4
5
|
export { installPlugin, listPlugins, removePlugin, parseSourceArg, } from './plugins.js';
|
|
5
6
|
export { createAuthoringPack, formatAuthoringPack, parseTypeList, } from './write.js';
|
|
7
|
+
export { QuoinCommand } from './base.js';
|
|
8
|
+
export { FlowCommand } from './flow-command.js';
|
|
9
|
+
export { resolveOrg, originOrg, UNRESOLVED_ORG_MESSAGE, type OrgSource, type ResolvedOrg, } from './org.js';
|
|
10
|
+
export { ixSchema, QuoinConfigSchema, QUOIN_PLUGIN_ID, QUOIN_ENV_BINDINGS, type QuoinConfig, } from './config-schema.js';
|
|
6
11
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EACL,aAAa,EACb,WAAW,EACX,YAAY,EACZ,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACL,UAAU,EACV,SAAS,EACT,sBAAsB,EACtB,KAAK,SAAS,EACd,KAAK,WAAW,GACjB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,QAAQ,EACR,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,KAAK,WAAW,GACjB,MAAM,oBAAoB,CAAC"}
|
package/dist/index.js
CHANGED
|
@@ -1,2 +1,9 @@
|
|
|
1
|
-
import {
|
|
2
|
-
|
|
1
|
+
import { n as e, t } from "./version-BF9oqMYd.js";
|
|
2
|
+
import { isVersionRequest as n, main as r } from "./cli.js";
|
|
3
|
+
import { i, n as a, o, r as s, t as c } from "./base-B_MXqS0S.js";
|
|
4
|
+
import { a as l, i as u, n as d, r as f } from "./plugins-ica0OxAT.js";
|
|
5
|
+
import { n as p, t as m } from "./modules-BcFs6dmB.js";
|
|
6
|
+
import { i as h, n as g, r as _, t as v } from "./config-schema-Dp-vlxuR.js";
|
|
7
|
+
import { a as y, i as b, n as x, o as S, r as C, t as w } from "./write-CLwhJDM2.js";
|
|
8
|
+
import { t as T } from "./flow-command-DTPkcpHy.js";
|
|
9
|
+
export { T as FlowCommand, v as QUOIN_ENV_BINDINGS, g as QUOIN_PLUGIN_ID, c as QuoinCommand, _ as QuoinConfigSchema, b as UNRESOLVED_ORG_MESSAGE, w as createAuthoringPack, a as defaultModuleRoots, m as defaultModulesManifest, p as ensureDefaultModules, s as filamentModulesDir, i as findCatalogEntry, x as formatAuthoringPack, d as installPlugin, n as isVersionRequest, h as ixSchema, f as listPlugins, o as loadCatalog, r as main, y as originOrg, t as packageVersion, u as parseSourceArg, C as parseTypeList, l as removePlugin, S as resolveOrg, e as resolveVersion };
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import { a as e } from "./base-B_MXqS0S.js";
|
|
2
|
+
import { t } from "./plugins-ica0OxAT.js";
|
|
3
|
+
import { readFileSync as n } from "node:fs";
|
|
4
|
+
import { dirname as r, join as i } from "node:path";
|
|
5
|
+
import { fileURLToPath as a } from "node:url";
|
|
6
|
+
import { parse as o } from "yaml";
|
|
7
|
+
import { reconcile as s, validateMarketplaceManifest as c } from "@agent-ix/ts-plugin-kit";
|
|
8
|
+
//#region src/modules.ts
|
|
9
|
+
function l() {
|
|
10
|
+
return r(r(a(import.meta.url)));
|
|
11
|
+
}
|
|
12
|
+
function u() {
|
|
13
|
+
return c(o(n(i(l(), "default-modules.yaml"), "utf8")));
|
|
14
|
+
}
|
|
15
|
+
function d(n = e(), r = u()) {
|
|
16
|
+
s(r, {
|
|
17
|
+
...t(n),
|
|
18
|
+
mode: "lazy"
|
|
19
|
+
});
|
|
20
|
+
}
|
|
21
|
+
//#endregion
|
|
22
|
+
export { d as n, u as t };
|
package/dist/org.d.ts
ADDED
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Where a resolved organization came from, or `none` when nothing yielded one.
|
|
3
|
+
*
|
|
4
|
+
* Reported alongside the organization itself so an author can tell an explicitly
|
|
5
|
+
* stated org from one inferred off the repository's remote.
|
|
6
|
+
*/
|
|
7
|
+
export type OrgSource = "flag" | "env" | "config" | "git" | "none";
|
|
8
|
+
export interface ResolvedOrg {
|
|
9
|
+
/** The organization, or `undefined` when unresolved. */
|
|
10
|
+
org?: string;
|
|
11
|
+
source: OrgSource;
|
|
12
|
+
}
|
|
13
|
+
/** Message shown when no source yielded an organization (FR-025, NFR-003). */
|
|
14
|
+
export declare const UNRESOLVED_ORG_MESSAGE: string;
|
|
15
|
+
/**
|
|
16
|
+
* Resolve the authoring organization for a repository (FR-025).
|
|
17
|
+
*
|
|
18
|
+
* Precedence, first non-empty wins: the explicit `--org` value, `QUOIN_ORG`,
|
|
19
|
+
* the stored config, then the `origin` remote in the repository's git config.
|
|
20
|
+
*
|
|
21
|
+
* A stored value outranks the remote because it is something a person said,
|
|
22
|
+
* where the remote is only what quoin could infer — but it does not weaken the
|
|
23
|
+
* no-substitution rule below: a config file is an explicit statement, never a
|
|
24
|
+
* value quoin picked. `QUOIN_ORG` is declared to `ConfigService` as an env
|
|
25
|
+
* binding, so it is checked here only when a caller supplies its own `env`
|
|
26
|
+
* (tests); in the normal path ConfigService layers it over the file itself,
|
|
27
|
+
* keeping one precedence rule in one place.
|
|
28
|
+
*
|
|
29
|
+
* Deliberately returns `source: "none"` rather than substituting a default. An
|
|
30
|
+
* org qualifies a repository so same-named repos in different organizations stay
|
|
31
|
+
* distinguishable, so inventing one defeats the point of carrying it — and a
|
|
32
|
+
* declared org is human-facing identity in a published artifact, where a
|
|
33
|
+
* plausible-but-wrong value is harder to notice than an absent one that stops
|
|
34
|
+
* the author and asks. (quire-rs #15 made org a required, caller-supplied input
|
|
35
|
+
* for the same reason; this is quoin's half of that contract.)
|
|
36
|
+
*
|
|
37
|
+
* Note this is a deliberate divergence from filament-ide-rs's `repo_identity`,
|
|
38
|
+
* which falls back to a `local` sentinel — correct there, because a code-symbol
|
|
39
|
+
* qualifier must always produce some name.
|
|
40
|
+
*/
|
|
41
|
+
export declare function resolveOrg(repoRoot: string, options?: {
|
|
42
|
+
flag?: string;
|
|
43
|
+
env?: NodeJS.ProcessEnv;
|
|
44
|
+
/**
|
|
45
|
+
* Project-local `.ix` layering overrides. Omit them in normal use:
|
|
46
|
+
* `BaseCommand.init` publishes the runtime context (honouring
|
|
47
|
+
* `--no-project-config`) and `ConfigService` falls back to it, so the
|
|
48
|
+
* project layer works without quoin threading anything. Supplied by tests
|
|
49
|
+
* that need a hermetic root.
|
|
50
|
+
*/
|
|
51
|
+
projectConfigRoot?: string;
|
|
52
|
+
projectConfigEnabled?: boolean;
|
|
53
|
+
}): ResolvedOrg;
|
|
54
|
+
/**
|
|
55
|
+
* Parse the org out of the `[remote "origin"]` url in a git config.
|
|
56
|
+
*
|
|
57
|
+
* Handles both `git@host:org/repo.git` and `https://host/org/repo.git`. Exported
|
|
58
|
+
* for direct testing of the url forms.
|
|
59
|
+
*/
|
|
60
|
+
export declare function originOrg(config: string): string | undefined;
|
|
61
|
+
//# sourceMappingURL=org.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"org.d.ts","sourceRoot":"","sources":["../src/org.ts"],"names":[],"mappings":"AAWA;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;AAEnE,MAAM,WAAW,WAAW;IAC1B,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,CAAC;CACnB;AAED,8EAA8E;AAC9E,eAAO,MAAM,sBAAsB,QAGoC,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IACP,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAC3B,GACL,WAAW,CAuBb;AAwFD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAmB5D"}
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
import { a as e, r as t } from "./base-B_MXqS0S.js";
|
|
2
|
+
import { existsSync as n, readFileSync as r, rmSync as i } from "node:fs";
|
|
3
|
+
import { basename as a, join as o } from "node:path";
|
|
4
|
+
import { parse as s } from "yaml";
|
|
5
|
+
import { installEntry as c, readRegistry as l, writeRegistry as u } from "@agent-ix/ts-plugin-kit";
|
|
6
|
+
//#region src/plugins.ts
|
|
7
|
+
function d(t = e()) {
|
|
8
|
+
return o(t, "filament", "registry.json");
|
|
9
|
+
}
|
|
10
|
+
function f(e) {
|
|
11
|
+
return {
|
|
12
|
+
cacheRoot: o(e, "cache", "ts-plugin-kit"),
|
|
13
|
+
targetRoot: t(e),
|
|
14
|
+
registryPath: d(e),
|
|
15
|
+
readName: _,
|
|
16
|
+
materialize: "copy"
|
|
17
|
+
};
|
|
18
|
+
}
|
|
19
|
+
function p(e) {
|
|
20
|
+
if (e.startsWith("path:")) return {
|
|
21
|
+
type: "path",
|
|
22
|
+
path: e.slice(5)
|
|
23
|
+
};
|
|
24
|
+
if (e.startsWith("github:")) {
|
|
25
|
+
let [t, n] = e.slice(7).split("@"), r = t.indexOf("//");
|
|
26
|
+
return r === -1 ? {
|
|
27
|
+
type: "github",
|
|
28
|
+
repo: t,
|
|
29
|
+
ref: n
|
|
30
|
+
} : {
|
|
31
|
+
type: "git-subdir",
|
|
32
|
+
url: t.slice(0, r),
|
|
33
|
+
path: t.slice(r + 2),
|
|
34
|
+
ref: n
|
|
35
|
+
};
|
|
36
|
+
}
|
|
37
|
+
if (e.startsWith("package:")) {
|
|
38
|
+
let t = e.slice(8), n = t.lastIndexOf("@");
|
|
39
|
+
return n > 0 ? {
|
|
40
|
+
type: "npm",
|
|
41
|
+
package: t.slice(0, n),
|
|
42
|
+
version: t.slice(n + 1)
|
|
43
|
+
} : {
|
|
44
|
+
type: "npm",
|
|
45
|
+
package: t
|
|
46
|
+
};
|
|
47
|
+
}
|
|
48
|
+
return {
|
|
49
|
+
type: "path",
|
|
50
|
+
path: e
|
|
51
|
+
};
|
|
52
|
+
}
|
|
53
|
+
function m(t, n = e()) {
|
|
54
|
+
return c({ source: p(t) }, f(n));
|
|
55
|
+
}
|
|
56
|
+
function h(t = e()) {
|
|
57
|
+
return l(d(t)).plugins;
|
|
58
|
+
}
|
|
59
|
+
function g(n, r = e()) {
|
|
60
|
+
let a = l(d(r));
|
|
61
|
+
i(o(t(r), n), {
|
|
62
|
+
force: !0,
|
|
63
|
+
recursive: !0
|
|
64
|
+
}), u(d(r), {
|
|
65
|
+
schemaVersion: 1,
|
|
66
|
+
plugins: a.plugins.filter((e) => e.name !== n)
|
|
67
|
+
});
|
|
68
|
+
}
|
|
69
|
+
function _(e) {
|
|
70
|
+
let t = n(o(e, "manifest.yaml")) ? o(e, "manifest.yaml") : o(e, a(e), "manifest.yaml");
|
|
71
|
+
if (!n(t)) throw Error(`no manifest.yaml found under ${e}`);
|
|
72
|
+
let i = s(r(t, "utf8"));
|
|
73
|
+
if (typeof i.name != "string" || i.name.length === 0) throw Error(`manifest ${t} has no name`);
|
|
74
|
+
return i.name;
|
|
75
|
+
}
|
|
76
|
+
//#endregion
|
|
77
|
+
export { g as a, p as i, m as n, h as r, f as t };
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { readFileSync as e } from "node:fs";
|
|
2
|
+
import { dirname as t, join as n } from "node:path";
|
|
3
|
+
import { fileURLToPath as r } from "node:url";
|
|
4
|
+
//#region src/version.ts
|
|
5
|
+
function i() {
|
|
6
|
+
let i = t(t(r(import.meta.url))), a = JSON.parse(e(n(i, "package.json"), "utf8"));
|
|
7
|
+
if (typeof a.version != "string") throw Error("package.json version is missing");
|
|
8
|
+
return a.version;
|
|
9
|
+
}
|
|
10
|
+
function a(e) {
|
|
11
|
+
return e || i();
|
|
12
|
+
}
|
|
13
|
+
function o() {
|
|
14
|
+
return a("0.6.0");
|
|
15
|
+
}
|
|
16
|
+
//#endregion
|
|
17
|
+
export { a as n, o as t };
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAsBA,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED,wBAAgB,cAAc,IAAI,MAAM,CAMvC"}
|
|
@@ -0,0 +1,156 @@
|
|
|
1
|
+
import { i as e } from "./base-B_MXqS0S.js";
|
|
2
|
+
import { n as t, r as n, t as r } from "./config-schema-Dp-vlxuR.js";
|
|
3
|
+
import { ConfigService as i } from "@agent-ix/ix-cli-core";
|
|
4
|
+
import { existsSync as a, readFileSync as o, statSync as s } from "node:fs";
|
|
5
|
+
import { join as c, resolve as l } from "node:path";
|
|
6
|
+
//#region src/org.ts
|
|
7
|
+
var u = "could not determine the authoring organization: no --org flag, no QUOIN_ORG, no stored config, and no [remote \"origin\"] in .git/config. Pass --org <name>, or store one with `quoin config set org <name>`.";
|
|
8
|
+
function d(e, t = {}) {
|
|
9
|
+
let n = t.flag?.trim();
|
|
10
|
+
if (n) return {
|
|
11
|
+
org: n,
|
|
12
|
+
source: "flag"
|
|
13
|
+
};
|
|
14
|
+
if (t.env) {
|
|
15
|
+
let e = t.env.QUOIN_ORG?.trim();
|
|
16
|
+
if (e) return {
|
|
17
|
+
org: e,
|
|
18
|
+
source: "env"
|
|
19
|
+
};
|
|
20
|
+
} else {
|
|
21
|
+
let e = f(t);
|
|
22
|
+
if (e) return {
|
|
23
|
+
org: e,
|
|
24
|
+
source: process.env.QUOIN_ORG?.trim() === e ? "env" : "config"
|
|
25
|
+
};
|
|
26
|
+
}
|
|
27
|
+
let r = p(e);
|
|
28
|
+
return r ? {
|
|
29
|
+
org: r,
|
|
30
|
+
source: "git"
|
|
31
|
+
} : { source: "none" };
|
|
32
|
+
}
|
|
33
|
+
function f(e) {
|
|
34
|
+
return i.forPlugin(t, n, {
|
|
35
|
+
envBindings: r,
|
|
36
|
+
...e.projectConfigRoot ? { projectConfigRoot: e.projectConfigRoot } : {},
|
|
37
|
+
...e.projectConfigEnabled === void 0 ? {} : { projectConfigEnabled: e.projectConfigEnabled }
|
|
38
|
+
}).get().org?.trim();
|
|
39
|
+
}
|
|
40
|
+
function p(e) {
|
|
41
|
+
let t = m(e);
|
|
42
|
+
if (t) try {
|
|
43
|
+
return h(o(c(t, "config"), "utf8"));
|
|
44
|
+
} catch {
|
|
45
|
+
return;
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
function m(e) {
|
|
49
|
+
let t = c(e, ".git"), n;
|
|
50
|
+
try {
|
|
51
|
+
n = s(t);
|
|
52
|
+
} catch {
|
|
53
|
+
return;
|
|
54
|
+
}
|
|
55
|
+
if (n.isDirectory()) return t;
|
|
56
|
+
try {
|
|
57
|
+
let n = o(t, "utf8").match(/^gitdir:\s*(.+)$/m)?.[1];
|
|
58
|
+
if (!n) return;
|
|
59
|
+
let r = l(e, n.trim());
|
|
60
|
+
try {
|
|
61
|
+
return l(r, o(c(r, "commondir"), "utf8").trim());
|
|
62
|
+
} catch {
|
|
63
|
+
return r;
|
|
64
|
+
}
|
|
65
|
+
} catch {
|
|
66
|
+
return;
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
function h(e) {
|
|
70
|
+
let t = !1;
|
|
71
|
+
for (let n of e.split("\n")) {
|
|
72
|
+
let e = n.trim();
|
|
73
|
+
if (e.startsWith("[")) {
|
|
74
|
+
t = e.replaceAll(/\s/g, "").toLowerCase().startsWith("[remote") && e.replaceAll(/\s/g, "").slice(7) === "\"origin\"]";
|
|
75
|
+
continue;
|
|
76
|
+
}
|
|
77
|
+
if (!t || !e.startsWith("url")) continue;
|
|
78
|
+
let r = e.slice(3).trimStart();
|
|
79
|
+
if (r.startsWith("=")) return g(r.slice(1).trim());
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
function g(e) {
|
|
83
|
+
let t, n = /^[A-Za-z][A-Za-z0-9+.-]*:\/\//.exec(e);
|
|
84
|
+
if (n) {
|
|
85
|
+
if (e.slice(0, n[0].length - 3).toLowerCase() === "file") return;
|
|
86
|
+
let r = e.slice(n[0].length).indexOf("/");
|
|
87
|
+
if (r === -1) return;
|
|
88
|
+
t = e.slice(n[0].length + r + 1);
|
|
89
|
+
} else if (!e.startsWith("/") && !e.startsWith(".") && !e.startsWith("~")) {
|
|
90
|
+
let n = e.indexOf(":");
|
|
91
|
+
if (n === -1) return;
|
|
92
|
+
t = e.slice(n + 1);
|
|
93
|
+
} else return;
|
|
94
|
+
let r = t.replace(/\/+$/, "").split("/").filter(Boolean);
|
|
95
|
+
if (!(r.length < 2)) return r[r.length - 2];
|
|
96
|
+
}
|
|
97
|
+
//#endregion
|
|
98
|
+
//#region src/write.ts
|
|
99
|
+
var _ = {
|
|
100
|
+
flag: "--org",
|
|
101
|
+
env: "QUOIN_ORG",
|
|
102
|
+
config: "stored config",
|
|
103
|
+
git: "git remote",
|
|
104
|
+
none: "nothing"
|
|
105
|
+
};
|
|
106
|
+
function v(e) {
|
|
107
|
+
return (Array.isArray(e) ? e : e ? [e] : []).flatMap((e) => e.split(",")).map((e) => e.trim()).filter(Boolean);
|
|
108
|
+
}
|
|
109
|
+
function y(t, n, r, i = {}) {
|
|
110
|
+
if (r.length === 0) throw Error("write requires --types <type[,type...]>");
|
|
111
|
+
let o = l(n);
|
|
112
|
+
if (!a(o) || !s(o).isDirectory()) throw Error(`write repo_dir is not a directory: ${n}`);
|
|
113
|
+
let c = r.map((n) => {
|
|
114
|
+
let r = e(t, n);
|
|
115
|
+
if (!r) throw Error(`catalog type not found: ${n}\nAvailable types: ${t.entries.map((e) => e.name).sort((e, t) => e.localeCompare(t)).join(", ")}`);
|
|
116
|
+
return x(r);
|
|
117
|
+
}), { org: u, source: f } = d(o, { flag: i.org });
|
|
118
|
+
return {
|
|
119
|
+
repoRoot: o,
|
|
120
|
+
...u ? { org: u } : {},
|
|
121
|
+
orgSource: f,
|
|
122
|
+
types: c,
|
|
123
|
+
validation: {
|
|
124
|
+
command: `quire validate --scope ${S(o)} "spec/**/*.md"`,
|
|
125
|
+
scope: o,
|
|
126
|
+
globs: ["spec/**/*.md"]
|
|
127
|
+
}
|
|
128
|
+
};
|
|
129
|
+
}
|
|
130
|
+
function b(e) {
|
|
131
|
+
let t = [
|
|
132
|
+
"quoin write",
|
|
133
|
+
"",
|
|
134
|
+
`Repo: ${e.repoRoot}`,
|
|
135
|
+
e.org ? `Org: ${e.org} (from ${_[e.orgSource]})` : `Org: unresolved — ${u}`,
|
|
136
|
+
"",
|
|
137
|
+
"Authoring contracts:"
|
|
138
|
+
];
|
|
139
|
+
for (let n of e.types) t.push(`- ${n.name} (${n.kind})`), t.push(` module: ${n.moduleName}`), t.push(` module_root: ${n.moduleRoot}`), n.skeletonPath && t.push(` skeleton: ${n.skeletonPath}`), n.schemaPath && t.push(` schema: ${n.schemaPath}`), !n.skeletonPath && !n.schemaPath && t.push(" contract: manifest only");
|
|
140
|
+
return t.push(""), t.push("Author files directly in the repo, then validate changed spec files."), t.push(`Validate scope: ${e.validation.scope}`), t.push(`Validate command: ${e.validation.command}`), t.join("\n");
|
|
141
|
+
}
|
|
142
|
+
function x(e) {
|
|
143
|
+
return {
|
|
144
|
+
name: e.name,
|
|
145
|
+
kind: e.kind,
|
|
146
|
+
moduleName: e.moduleName,
|
|
147
|
+
moduleRoot: e.moduleRoot,
|
|
148
|
+
...e.schemaPath ? { schemaPath: e.schemaPath } : {},
|
|
149
|
+
...e.skeletonPath ? { skeletonPath: e.skeletonPath } : {}
|
|
150
|
+
};
|
|
151
|
+
}
|
|
152
|
+
function S(e) {
|
|
153
|
+
return /^[A-Za-z0-9_./:-]+$/.test(e) ? e : `'${e.replaceAll("'", "'\\''")}'`;
|
|
154
|
+
}
|
|
155
|
+
//#endregion
|
|
156
|
+
export { h as a, u as i, b as n, d as o, v as r, y as t };
|
package/dist/write.d.ts
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { SpecCatalog } from './catalog.js';
|
|
2
|
+
import { OrgSource } from './org.js';
|
|
2
3
|
export interface AuthoringContract {
|
|
3
4
|
name: string;
|
|
4
5
|
kind: "artifact" | "object";
|
|
@@ -9,6 +10,9 @@ export interface AuthoringContract {
|
|
|
9
10
|
}
|
|
10
11
|
export interface AuthoringPack {
|
|
11
12
|
repoRoot: string;
|
|
13
|
+
/** Authoring organization, absent when no source yielded one (FR-025). */
|
|
14
|
+
org?: string;
|
|
15
|
+
orgSource: OrgSource;
|
|
12
16
|
types: AuthoringContract[];
|
|
13
17
|
validation: {
|
|
14
18
|
command: string;
|
|
@@ -17,6 +21,8 @@ export interface AuthoringPack {
|
|
|
17
21
|
};
|
|
18
22
|
}
|
|
19
23
|
export declare function parseTypeList(value: string | string[] | undefined): string[];
|
|
20
|
-
export declare function createAuthoringPack(catalog: SpecCatalog, repoDir: string, typeNames: string[]
|
|
24
|
+
export declare function createAuthoringPack(catalog: SpecCatalog, repoDir: string, typeNames: string[], options?: {
|
|
25
|
+
org?: string;
|
|
26
|
+
}): AuthoringPack;
|
|
21
27
|
export declare function formatAuthoringPack(pack: AuthoringPack): string;
|
|
22
28
|
//# sourceMappingURL=write.d.ts.map
|
package/dist/write.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../src/write.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,WAAW,EAGjB,MAAM,cAAc,CAAC;
|
|
1
|
+
{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../src/write.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,WAAW,EAGjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAA0B,KAAK,SAAS,EAAc,MAAM,UAAU,CAAC;AAW9E,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,UAAU,EAAE;QACV,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;CACH;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,EAAE,CAM5E;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7B,aAAa,CAmCf;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CA4B/D"}
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@agent-ix/quoin",
|
|
3
3
|
"description": "Spec-driven development for Claude Code — author validated, ISO/IEC/IEEE 29148-aligned specs, then plan and build against them.",
|
|
4
|
-
"version": "0.
|
|
4
|
+
"version": "0.6.0",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
7
7
|
"files": [
|
|
@@ -21,6 +21,29 @@
|
|
|
21
21
|
"bin": {
|
|
22
22
|
"quoin": "bin/quoin.js"
|
|
23
23
|
},
|
|
24
|
+
"oclif": {
|
|
25
|
+
"bin": "quoin",
|
|
26
|
+
"dirname": "quoin",
|
|
27
|
+
"commands": "./dist/commands",
|
|
28
|
+
"topicSeparator": " ",
|
|
29
|
+
"topics": {
|
|
30
|
+
"catalog": {
|
|
31
|
+
"description": "Inspect the active artifact/object catalog (list, show, validate)."
|
|
32
|
+
},
|
|
33
|
+
"config": {
|
|
34
|
+
"description": "Read and store quoin configuration (get, set, edit, doctor)."
|
|
35
|
+
},
|
|
36
|
+
"module": {
|
|
37
|
+
"description": "Install and manage user/community spec modules (list, install, remove, ensure-defaults)."
|
|
38
|
+
},
|
|
39
|
+
"plugin": {
|
|
40
|
+
"description": "[DEPRECATED] Renamed to `module`; retained as a forwarding alias."
|
|
41
|
+
}
|
|
42
|
+
},
|
|
43
|
+
"plugins": [
|
|
44
|
+
"@agent-ix/filament-plan-sync"
|
|
45
|
+
]
|
|
46
|
+
},
|
|
24
47
|
"packageManager": "pnpm@10.33.4",
|
|
25
48
|
"scripts": {
|
|
26
49
|
"help": "node scripts/help.js",
|
|
@@ -57,9 +80,12 @@
|
|
|
57
80
|
"test-results:warnings": "./node_modules/.bin/jest-results warnings"
|
|
58
81
|
},
|
|
59
82
|
"dependencies": {
|
|
60
|
-
"@agent-ix/
|
|
83
|
+
"@agent-ix/filament-plan-sync": ">=0.1.0",
|
|
84
|
+
"@agent-ix/ix-cli-core": ">=0.12.0",
|
|
61
85
|
"@agent-ix/ts-plugin-kit": ">=0.1.3",
|
|
62
|
-
"
|
|
86
|
+
"@oclif/core": ">=4.11.14",
|
|
87
|
+
"yaml": "^2.9.0",
|
|
88
|
+
"zod": ">=4.4.3"
|
|
63
89
|
},
|
|
64
90
|
"devDependencies": {
|
|
65
91
|
"@types/node": "25.9.2",
|
|
@@ -84,5 +110,10 @@
|
|
|
84
110
|
"repository": {
|
|
85
111
|
"type": "git",
|
|
86
112
|
"url": "git+https://github.com/agent-ix/quoin.git"
|
|
113
|
+
},
|
|
114
|
+
"pnpm": {
|
|
115
|
+
"overrides": {
|
|
116
|
+
"brace-expansion": ">=5.0.8"
|
|
117
|
+
}
|
|
87
118
|
}
|
|
88
119
|
}
|
|
@@ -50,8 +50,11 @@ All steps required!
|
|
|
50
50
|
This skill produces or updates a **plan bundle** at `<project_root>/plan/<Plan-id>-<slug>/`:
|
|
51
51
|
|
|
52
52
|
- `plan.md` (`type: Plan`): The central living document — requirements summary,
|
|
53
|
-
dependency graph, execution tracks, quality gates, and test plan.
|
|
54
|
-
|
|
53
|
+
dependency graph, execution tracks, quality gates, and test plan. It is an
|
|
54
|
+
**orchestration overview, not a mirror of the bundle**: ownership, the DAG, and test
|
|
55
|
+
traces are authoritative in the task frontmatter, so `plan.md` states each fact once
|
|
56
|
+
(see `references/step-3-execution-plan.md`). Frontmatter `relationships:` trace
|
|
57
|
+
(`references`) the requirements the plan covers.
|
|
55
58
|
- `tasks/Task-NNN-<slug>.md` (`type: Task`): One file per task. Frontmatter carries
|
|
56
59
|
the machine contract — `status`, `track`, `priority`, and `relationships:` edges
|
|
57
60
|
(`depends_on` for the DAG, `references` for requirement ownership, `verifies` for
|
|
@@ -75,4 +75,14 @@ relationships:
|
|
|
75
75
|
### Cross-cutting constraints
|
|
76
76
|
- `NFR-001` applies to [which code paths].
|
|
77
77
|
- `NFR-002` applies to [which merge points].
|
|
78
|
+
|
|
79
|
+
### The seams (optional)
|
|
80
|
+
One short paragraph grounding the plan in the existing code — the concrete files,
|
|
81
|
+
functions, or boundaries each track attaches to (e.g. "FR-021 widens the write guard in
|
|
82
|
+
`authorize.ts`; FR-022 reuses the existing `chokidar-change-source.ts`"). Keep it to a
|
|
83
|
+
few sentences; omit if the spec is greenfield.
|
|
78
84
|
```
|
|
85
|
+
|
|
86
|
+
This is the **single** dependency-graph representation for the bundle. Step 3 references
|
|
87
|
+
it — it does not re-emit a "Remaining Dependency Graph" or a separate "Execution Tracks"
|
|
88
|
+
section.
|
|
@@ -37,3 +37,7 @@
|
|
|
37
37
|
### Verification (NFRs)
|
|
38
38
|
- [ ] **verify_response_time** (NFR-001): Run load test to ensure p95 < 200ms.
|
|
39
39
|
```
|
|
40
|
+
|
|
41
|
+
This is the **single** TC enumeration for the bundle. Downstream sections reference TC
|
|
42
|
+
ids only via the Step 3 **Task File Mapping** table — do not re-list them per track or in
|
|
43
|
+
track exit-criteria.
|
|
@@ -64,7 +64,8 @@ A gate is a checkpoint where you validate a fundamental assumption before invest
|
|
|
64
64
|
- Before starting optimization work (confirm correctness first)
|
|
65
65
|
- Before starting dependent work that would need rework if the gate fails
|
|
66
66
|
|
|
67
|
-
**Gate format
|
|
67
|
+
**Gate format** (this is the thinking format; in `plan.md` the gate is rendered
|
|
68
|
+
**once**, as a one-liner inline in its track — see Output Format below):
|
|
68
69
|
```markdown
|
|
69
70
|
#### Gate: [Name]
|
|
70
71
|
- **Measures:** [What you're validating]
|
|
@@ -155,41 +156,46 @@ the `plan.md` body — see the Output Format below.
|
|
|
155
156
|
|
|
156
157
|
## Output Format (appended to plan/<Plan-id>-<slug>/plan.md)
|
|
157
158
|
|
|
159
|
+
`plan.md` is an **orchestration overview, not a mirror of the bundle.** Ownership, the
|
|
160
|
+
DAG, and test traces are authoritative in **task frontmatter** (`references`,
|
|
161
|
+
`depends_on`, `verifies`). State each fact **once**: the requirement checklist in
|
|
162
|
+
Requirements Summary (Step 1), the dependency *reasons* in the Dependency Graph (Step 1),
|
|
163
|
+
the TC enumeration in the Test Plan (Step 2), and the per-task row in the Task File
|
|
164
|
+
Mapping below. Step 3 appends only the sections below — it does **not** re-emit the
|
|
165
|
+
dependency graph, add a separate "Execution Tracks" section, restate any task's
|
|
166
|
+
`## Scope`, or re-list TC ids per track.
|
|
167
|
+
|
|
158
168
|
```markdown
|
|
159
169
|
## Remaining Work
|
|
160
170
|
|
|
161
|
-
|
|
162
|
-
|
|
171
|
+
Describe the tracks **once**, here. One line per item: title, difficulty (optional
|
|
172
|
+
size estimate), and a *behavioral* exit criterion. The item's scope and subtasks live
|
|
173
|
+
in its task file — do not repeat them. Do not list TC ids here; they live in the Test
|
|
174
|
+
Plan and the Task File Mapping.
|
|
163
175
|
|
|
164
176
|
### Track A: Critical Path (serial)
|
|
165
|
-
|
|
166
|
-
- **
|
|
167
|
-
- **
|
|
168
|
-
- **Estimated new code:** ~NNN lines
|
|
169
|
-
- **Exit criteria:** ...
|
|
170
|
-
|
|
171
|
-
#### A2: [Second step]
|
|
172
|
-
...
|
|
173
|
-
|
|
174
|
-
#### Gate: [Quality checkpoint]
|
|
175
|
-
- **Measures:** ...
|
|
176
|
-
- **Pass criteria:** ...
|
|
177
|
+
- **A1 = Task-NNN** [title] — [Easy|Medium|Hard], ~NNN lines; exit: [behavioral outcome, e.g. "converges with no acknowledged loss"].
|
|
178
|
+
- **A2 = Task-NNN** [title] — [difficulty]; exit: [behavioral outcome].
|
|
179
|
+
- **Gate = Task-NNN** [name] — measures [what]; pass: [threshold]. (State each gate once, here in its track — never also in a separate section.)
|
|
177
180
|
|
|
178
181
|
### Track B: Parallel (independent agent, can start now)
|
|
179
|
-
|
|
180
|
-
...
|
|
182
|
+
- **B1 = Task-NNN** [title] — [difficulty]; exit: [behavioral outcome].
|
|
181
183
|
|
|
182
184
|
### Track C: Post-Gate
|
|
183
|
-
|
|
184
|
-
...
|
|
185
|
+
- **C1 = Task-NNN** [title] — [difficulty]; exit: [behavioral outcome].
|
|
185
186
|
|
|
186
187
|
## Parallel Execution Summary
|
|
187
|
-
[ASCII timeline showing tracks running concurrently]
|
|
188
|
+
[ASCII timeline showing the tracks running concurrently.]
|
|
188
189
|
|
|
189
190
|
## Task File Mapping
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
human-readable mirror
|
|
191
|
+
|
|
192
|
+
The single per-task table — the only place that enumerates per-task ownership and
|
|
193
|
+
verification. It is a human-readable mirror of the task frontmatter, which stays
|
|
194
|
+
authoritative for status and edges.
|
|
195
|
+
|
|
196
|
+
| Task | Track | Owns (references) | Verified by (verifies) | Status |
|
|
197
|
+
| -------- | ----- | ----------------- | ---------------------- | ----------- |
|
|
198
|
+
| Task-NNN | A | FR-00X | TC-0XX…TC-0XX | not_started |
|
|
193
199
|
|
|
194
200
|
## Coordination Rules
|
|
195
201
|
[What to freeze, what not to start early, shared-file/shared-state single-writer
|
|
@@ -198,6 +204,13 @@ discipline, merge sequencing.]
|
|
|
198
204
|
|
|
199
205
|
## Common Mistakes to Avoid
|
|
200
206
|
|
|
207
|
+
- **Mirroring frontmatter in prose.** `plan.md` is an orchestration overview; ownership,
|
|
208
|
+
the DAG, and test traces are authoritative in task frontmatter (`references`,
|
|
209
|
+
`depends_on`, `verifies`). State each fact once — requirement checklist (Requirements
|
|
210
|
+
Summary), dependency reasons (Dependency Graph), TC enumeration (Test Plan), per-task
|
|
211
|
+
row (Task File Mapping). Do not add a second "Execution Tracks" section, re-emit the
|
|
212
|
+
dependency graph, re-list TC ids in track exit-criteria, restate a task's `## Scope`,
|
|
213
|
+
or describe a gate twice.
|
|
201
214
|
- **Bundling done + remaining work in one task.** If build is done but scan isn't, they're separate tasks even if they were originally planned together.
|
|
202
215
|
- **Missing shared dependencies.** If two items need the same algorithm, extract it as a deliverable — don't let two parallel workers implement it independently.
|
|
203
216
|
- **No gates.** If the whole system's value depends on one unproven property (e.g., recall quality), measure it before building everything around it.
|
package/skills/specify/SKILL.md
CHANGED
|
@@ -66,6 +66,11 @@ Run only the steps the request needs; stop after IT.
|
|
|
66
66
|
2. Run `quoin write <repo_dir> --types <type[,type...]>` **once** for the full
|
|
67
67
|
set. Use the returned skeletons, schemas, module roots, and examples as the
|
|
68
68
|
authoring contract — the per-type rules live in the template, not your memory.
|
|
69
|
+
The pack also reports the repo's `Org:`; use that value for the `org:` field
|
|
70
|
+
and for the `ix://<org>/<repo>/…` targets you write. If it reports
|
|
71
|
+
`Org: unresolved`, ask the user which organization owns the repo — never
|
|
72
|
+
invent one, never leave a literal `<your-org>` in a file, and never copy the
|
|
73
|
+
org out of a skeleton's example values.
|
|
69
74
|
3. Author each artifact as its own file (table above), in this logical order,
|
|
70
75
|
skipping any type not requested:
|
|
71
76
|
- `spec.md` — **REQUIRED when starting a new spec**: the
|