mcoda 0.1.15 → 0.1.16

package/dist/bin/McodaEntrypoint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"McodaEntrypoint.d.ts","sourceRoot":"","sources":["../../src/bin/McodaEntrypoint.ts"],"names":[],"mappings":";AA2BA,qBAAa,eAAe;WACb,GAAG,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;CAkLxE"}
+{"version":3,"file":"McodaEntrypoint.d.ts","sourceRoot":"","sources":["../../src/bin/McodaEntrypoint.ts"],"names":[],"mappings":";AA4BA,qBAAa,eAAe;WACb,GAAG,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;CAsLxE"}

package/dist/bin/McodaEntrypoint.js

@@ -24,6 +24,7 @@ import { RoutingCommands } from "../commands/routing/RoutingCommands.js";
 import { TestAgentCommand } from "../commands/agents/TestAgentCommand.js";
 import { AgentRunCommand } from "../commands/agents/AgentRunCommand.js";
 import { SetWorkspaceCommand } from "../commands/workspace/SetWorkspaceCommand.js";
+import { ProjectGuidanceCommand } from "../commands/workspace/ProjectGuidanceCommand.js";
 export class McodaEntrypoint {
     static async run(argv = process.argv.slice(2)) {
         const applyCodexNoSandboxFlag = (value) => {
@@ -79,7 +80,7 @@ export class McodaEntrypoint {
             return;
         }
         if (!command) {
-            throw new Error("Usage: mcoda <agent|gateway-agent|test-agent|agent-run|routing|docs|openapi|job|jobs|tokens|telemetry|create-tasks|migrate-tasks|refine-tasks|order-tasks|tasks|work-on-tasks|gateway-trio|code-review|qa-tasks|backlog|task|task-detail|estimate|update|set-workspace|pdr|sds> [...args]\n" +
+            throw new Error("Usage: mcoda <agent|gateway-agent|test-agent|agent-run|routing|docs|openapi|job|jobs|tokens|telemetry|create-tasks|migrate-tasks|refine-tasks|order-tasks|tasks|work-on-tasks|gateway-trio|code-review|qa-tasks|backlog|task|task-detail|estimate|update|set-workspace|project-guidance|pdr|sds> [...args]\n" +
                 "Routing: use `mcoda routing defaults` to view/update workspace/global defaults, `mcoda routing preview|explain` to inspect agent selection/provenance (override → workspace_default → global_default).\n" +
                 "Aliases: `tasks order-by-deps` forwards to `order-tasks` (dependency-aware ordering), `task`/`task-detail` show a single task.\n" +
                 "Job commands (mcoda job --help for details): list|status|watch|logs|inspect|resume|cancel|tokens\n" +
@@ -197,6 +198,10 @@ export class McodaEntrypoint {
             await SetWorkspaceCommand.run(rest);
             return;
         }
+        if (command === "project-guidance") {
+            await ProjectGuidanceCommand.run(rest);
+            return;
+        }
         throw new Error(`Unknown command: ${command}`);
     }
 }

package/dist/commands/backlog/BacklogCommands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BacklogCommands.d.ts","sourceRoot":"","sources":["../../../src/commands/backlog/BacklogCommands.ts"],"names":[],"mappings":"AAIA,UAAU,UAAU;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,IAAI,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AA6BD,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,EAAE,KAAG,UAsHjD,CAAC;AAgLF,qBAAa,eAAe;WACb,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CA4DhD"}
+{"version":3,"file":"BacklogCommands.d.ts","sourceRoot":"","sources":["../../../src/commands/backlog/BacklogCommands.ts"],"names":[],"mappings":"AAIA,UAAU,UAAU;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,IAAI,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AA6BD,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,EAAE,KAAG,UAuHjD,CAAC;AAgLF,qBAAa,eAAe;WACb,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CA4DhD"}

package/dist/commands/backlog/BacklogCommands.js

@@ -12,7 +12,7 @@ const usage = `mcoda backlog \\
   [--include-done] \\
   [--include-cancelled] \\
   [--order dependencies]   # dependency-aware ordering (topological, most depended-on first) \\
-  [--view summary|epics|stories|tasks] \\
+  [--view summary|epics|stories|tasks] # default: tasks \\
   [--limit <N> | --top <N>] \\
   [--json] \\
   [--verbose]`;
@@ -32,6 +32,7 @@ export const parseBacklogArgs = (argv) => {
         includeDone: false,
         includeCancelled: false,
         orderDependencies: false,
+        view: "tasks",
         json: false,
         verbose: false,
     };

package/dist/commands/workspace/ProjectGuidanceCommand.d.ts

@@ -0,0 +1,11 @@
+export interface ParsedProjectGuidanceArgs {
+    workspaceRoot?: string;
+    force: boolean;
+    json: boolean;
+    help: boolean;
+}
+export declare const parseProjectGuidanceArgs: (argv: string[]) => ParsedProjectGuidanceArgs;
+export declare class ProjectGuidanceCommand {
+    static run(argv: string[]): Promise<void>;
+}
+//# sourceMappingURL=ProjectGuidanceCommand.d.ts.map

package/dist/commands/workspace/ProjectGuidanceCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectGuidanceCommand.d.ts","sourceRoot":"","sources":["../../../src/commands/workspace/ProjectGuidanceCommand.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,yBAAyB;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAUD,eAAO,MAAM,wBAAwB,GAAI,MAAM,MAAM,EAAE,KAAG,yBAqDzD,CAAC;AAEF,qBAAa,sBAAsB;WACpB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CA0ChD"}

package/dist/commands/workspace/ProjectGuidanceCommand.js

@@ -0,0 +1,107 @@
+import path from "node:path";
+import { WorkspaceResolver, ensureProjectGuidance } from "@mcoda/core";
+const USAGE = "Usage: mcoda project-guidance [--workspace <path>|--workspace-root <path>] [--force] [--json]";
+const parseBooleanFlag = (value, defaultValue) => {
+    if (value === undefined)
+        return defaultValue;
+    const normalized = value.trim().toLowerCase();
+    if (["0", "false", "off", "no"].includes(normalized))
+        return false;
+    if (["1", "true", "on", "yes"].includes(normalized))
+        return true;
+    return defaultValue;
+};
+export const parseProjectGuidanceArgs = (argv) => {
+    const parsed = {
+        force: false,
+        json: false,
+        help: false,
+    };
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg.startsWith("--workspace-root=") || arg.startsWith("--workspace=")) {
+            const [, raw] = arg.split("=", 2);
+            if (raw)
+                parsed.workspaceRoot = path.resolve(raw);
+            continue;
+        }
+        if (arg.startsWith("--force=")) {
+            const [, raw] = arg.split("=", 2);
+            parsed.force = parseBooleanFlag(raw, true);
+            continue;
+        }
+        if (arg.startsWith("--json=")) {
+            const [, raw] = arg.split("=", 2);
+            parsed.json = parseBooleanFlag(raw, true);
+            continue;
+        }
+        switch (arg) {
+            case "--workspace":
+            case "--workspace-root":
+                if (argv[i + 1]) {
+                    parsed.workspaceRoot = path.resolve(argv[i + 1]);
+                    i += 1;
+                }
+                break;
+            case "--force": {
+                const next = argv[i + 1];
+                if (next && !next.startsWith("--")) {
+                    parsed.force = parseBooleanFlag(next, true);
+                    i += 1;
+                }
+                else {
+                    parsed.force = true;
+                }
+                break;
+            }
+            case "--json":
+                parsed.json = true;
+                break;
+            case "--help":
+            case "-h":
+                parsed.help = true;
+                break;
+            default:
+                break;
+        }
+    }
+    return parsed;
+};
+export class ProjectGuidanceCommand {
+    static async run(argv) {
+        const parsed = parseProjectGuidanceArgs(argv);
+        if (parsed.help) {
+            // eslint-disable-next-line no-console
+            console.log(USAGE);
+            return;
+        }
+        try {
+            const workspace = await WorkspaceResolver.resolveWorkspace({
+                cwd: process.cwd(),
+                explicitWorkspace: parsed.workspaceRoot,
+            });
+            const result = await ensureProjectGuidance(workspace.workspaceRoot, {
+                mcodaDir: workspace.mcodaDir,
+                force: parsed.force,
+            });
+            if (parsed.json) {
+                // eslint-disable-next-line no-console
+                console.log(JSON.stringify({
+                    workspaceRoot: workspace.workspaceRoot,
+                    mcodaDir: workspace.mcodaDir,
+                    path: result.path,
+                    status: result.status,
+                }, null, 2));
+                return;
+            }
+            // eslint-disable-next-line no-console
+            console.log(`project-guidance ${result.status}: ${result.path}`);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            // eslint-disable-next-line no-console
+            console.error(`project-guidance failed: ${message}`);
+            process.exitCode = 1;
+        }
+    }
+}

package/dist/index.d.ts

@@ -17,4 +17,5 @@ export * from "./commands/planning/QaTasksCommand.js";
 export * from "./commands/update/UpdateCommands.js";
 export * from "./commands/routing/RoutingCommands.js";
 export * from "./commands/agents/TestAgentCommand.js";
+export * from "./commands/workspace/ProjectGuidanceCommand.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAC;AACpD,cAAc,0BAA0B,CAAC;AACzC,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AACtD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,uCAAuC,CAAC;AACtD,cAAc,wCAAwC,CAAC;AACvD,cAAc,yCAAyC,CAAC;AACxD,cAAc,yCAAyC,CAAC;AACxD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,uCAAuC,CAAC;AACtD,cAAc,uCAAuC,CAAC;AACtD,cAAc,wCAAwC,CAAC;AACvD,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,uCAAuC,CAAC;AACtD,cAAc,uCAAuC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAC;AACpD,cAAc,0BAA0B,CAAC;AACzC,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AACtD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,uCAAuC,CAAC;AACtD,cAAc,wCAAwC,CAAC;AACvD,cAAc,yCAAyC,CAAC;AACxD,cAAc,yCAAyC,CAAC;AACxD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,uCAAuC,CAAC;AACtD,cAAc,uCAAuC,CAAC;AACtD,cAAc,wCAAwC,CAAC;AACvD,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,uCAAuC,CAAC;AACtD,cAAc,uCAAuC,CAAC;AACtD,cAAc,gDAAgD,CAAC"}

package/dist/index.js

@@ -17,3 +17,4 @@ export * from "./commands/planning/QaTasksCommand.js";
 export * from "./commands/update/UpdateCommands.js";
 export * from "./commands/routing/RoutingCommands.js";
 export * from "./commands/agents/TestAgentCommand.js";
+export * from "./commands/workspace/ProjectGuidanceCommand.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcoda",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "description": "Local-first CLI for planning, documentation, and execution workflows with agent assistance.",
   "type": "module",
   "main": "dist/index.js",
@@ -45,12 +45,12 @@
   },
   "dependencies": {
     "yaml": "^2.4.2",
-    "@mcoda/core": "0.1.15",
-    "@mcoda/shared": "0.1.15"
+    "@mcoda/core": "0.1.16",
+    "@mcoda/shared": "0.1.16"
   },
   "devDependencies": {
-    "@mcoda/db": "0.1.15",
-    "@mcoda/integrations": "0.1.15"
+    "@mcoda/integrations": "0.1.16",
+    "@mcoda/db": "0.1.16"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",